Copyright: Copyright © 1992-1995 ForeFront Inc.
Citation: Copyright © 1992-1995 ForeFront Inc.


#define

A statement in the [Map] section of the .HPJ file or in a context mapping include file that links a context string to a context number.  ForeHelp uses the following formats in the .HPJ file and in an optional context map file:

In .HPJ file or C language context map file:

#define context_string context_number

In Pascal or Visual Basic context map file:

const context_string=context_number


#include

A statement in the [Map] section of the .HPJ file or in a context map file that refers to an external context mapping header file.  The format in the [Map] section is:

#include <filename.h>


$FILENAME.DBA
$FILENAM.DBA

$FILENAM.DBA is the name that ForeHelp assigns to your original database file (FILENAME.DBA) if you choose to open the temporary copy of your database in the event of a crash.  If the temporary copy opens correctly, ForeHelp saves it using the original file name and overwrites $FILENAM.DBA.  If there is a problem with the temporary file, ForeHelp does not save it as the original.  In this case, you can rename $FILENAM.DBA to save it as the original.  See Opening a Damaged Help Project.


.BAS

.BAS is the file name extension of a Visual Basic file, which ForeHelp can create when you want to provide context-map files for use with a Visual Basic application.


.BMP

.BMP is the file name extension of a Windows bitmap file, which is a device-independent image created using patterns of dots.


.DBA

.DBA is the file name extension assigned to a new help project.  ForeHelp creates a series of database files for your project with the extensions .DBA, .DBB, .DBC, .DBD, .DBE, .DBF, and .DBG.  ForeHelp requires all of these files--be sure not to delete any of them.  If you enter an extension other than .DBA for a new help project, ForeHelp converts the extension to .DBA.


.DIB

.DIB is a file name extension of a Device Independent Bitmap, a type of Windows bitmap file.


.FHB

.FHB is the file name extension for a ForeHelp Backup file.  You create a backup file by choosing the File|Backup command or clicking on the [image] toolbar button.  See Backups.


.H

.H is the file name extension of a C header file, which ForeHelp uses for context-map files.


.HLP

.HLP is the file name extension for a WinHelp file, the product of your help project.


.HPJ

.HPJ is the file name extension of a help project file, which ForeHelp creates during the first phase of the build procedure.  This file contains your database structure and hypertext information.  You can use an existing help project created by ForeHelp (or in another help authoring tool) by opening the .HPJ file in the New/Open/Open As Template dialog box.


.HPP

.HPP is the file name extension of a C++ context-map file.


.ICO

.ICO is the file name extension assigned to an icon file.  You can assign an icon to your help file in the Project Properties dialog box.  Many icon editing programs allow you to create .ICO files, which you can then use with ForeHelp.


.MRB

.MRB is the file name extension of a multiple resolution bitmap file.  The file contains multiple bitmaps of the same graphic.  WinHelp displays the bitmap appropriate for the resolution of the display device.


.PAS

.PAS is the file name extension of a Pascal file, which ForeHelp can read or create when you want to provide context-map files for use with an application written in Pascal.


.RTF

.RTF is the file name extension of a Rich Text Format file.  Rich Text Format is a standard set of formatting codes that many word processing software packages on Windows and Macintosh systems can import and export.  .RTF files enable users to transfer documents between different packages without losing text formatting.  You can insert .RTF files from other software packages into your ForeHelp project.  See Inserting Rich Text Format (.RTF) Files.

ForeHelp creates one or more .RTF files for your topic data during the first phase of the build process.  You can organize your topics into different .RTF files.  The Reporter can display and print a list of all .RTF files used in your project with or without the topics that are assigned to each .RTF file.  The Reporter can also display and print the .RTF file name for any selected topics.

ForeHelp can generate a special .RTF file for use as a hardcopy manual.  See Generating Manuals.


.SHG

A segmented hypergraphic (.SHG) file is a WinHelp graphic file with hotspots in it.  You can insert a bitmap (.BMP) or metafile (.WMF) into your topic and use ForeHelp's Sheg Editor to create hotspots, which allows the reader to execute jumps, popups, or macros from the graphic.  When you exit the Sheg Editor, the .BMP or .WMF file then becomes a .SHG file.

After creating a .SHG file, you can cut or copy it from the current topic and paste it elsewhere in the project.  You can also insert a .SHG file into any ForeHelp project.


.TMP

If you scale or crop a bitmap picture in ForeHelp, ForeHelp creates a new file during the build process.  This file's name is FHXXXXXX.TMP, where XXXXXX is a randomly generated number.


.TXT

.TXT is the file name extension of a standard ASCII file, which consists of text only (with most formatting instructions excluded).  Most word processing software packages can export .TXT files.  You can insert .TXT files into a ForeHelp topic and then format the text.  See Inserting Text Files.


.WMF

.WMF is the file name extension of a Windows Metafile.  Metafiles are collections of graphics device interface (GDI) function calls that create specific images on a device.


256-Color Bitmap DLL

This topic contains the following sections:

To Use the 256-Color Bitmap DLL

To Remove a Picture That Uses the 256-Color Bitmap DLL

WinHelp does not support the display of 256-color bitmaps.  When you insert a picture created in 256-color mode, WinHelp converts it to the basic 16-color Windows palette regardless of the display capability of the computer screen.  ForeHelp's 256-color bitmap dynamic link library (DLL) enables you to display bitmaps created with the 256-color palette in WinHelp.  Use this DLL when you know that your help file will be used on a system that has 256 colors or more.

To Use the 256-Color Bitmap DLL

1.	Choose the Text|Insert Special command to access the Insert Special menu.

2.	Select 256-Color Bitmap from the menu.
The Choose Baggage Files dialog box appears.

3.	In the File Name field, enter the name of the graphic file; or choose the Browse button to display the Find External File dialog box, in which you can select the graphic file and its location; or select one of the files listed in the Baggage Files box.

4.	To include the graphic file within the compiled help file, choose the Add to Baggage button.
The name of the graphic file appears in the Baggage Files box.  If you do not add this file to baggage, you must provide the file separately when you distribute your help file to your readers.

5.	If you decide to use another DLL, choose the Change DLL button.
The Choose Embedded Window DLL dialog box appears, in which you can select another DLL.  This is a standard Windows file open dialog box.

To Remove the Picture That Uses the 256-Color Bitmap DLL

If you decide to remove a picture that uses the 256-color bitmap DLL, simply select the picture in your help project and press Delete.  You should also remove the graphic file from the baggage list by choosing the Project|Baggage command in ForeHelp, selecting the name of the file from the list, and choosing the Remove button.


Accelerator Key

An accelerator key is a shortcut to an application's commands using the keyboard rather than the mouse.  Accelerator keys typically enable you to perform actions such as display menus, choose menu commands without displaying the menu, access a dialog box, assign styles, and so forth.  The underline under a character in a menu option indicates the accelerator key.  To use the accelerator, press [image] or [image] plus the underlined character.  For a list of ForeHelp's accelerator keys, see Keyboard Shortcuts.

You can assign accelerator keys to ForeHelp paragraph styles.  To assign accelerator keys to a new style, see Creating New Styles.  To assign, change, or remove an accelerator key from an existing style, see Editing Styles.  To use a style accelerator key, press [image] plus the number key defined for the style.


Accessing Macro Dialog Boxes

This topic contains the following sections:

To Access the Project Macros Dialog Box

To Access the Macro Editor for Topic Macros

To Create a Hotspot Macro

To Edit a Hotspot Macro

ForeHelp provides dialog boxes for creating and editing project macros, for creating and editing topic macros, for creating hotspot macros, and for editing hotspot macros.  See Adding Macros for instructions on using these dialog boxes.

To Access the Project Macros Dialog Box

1.	Place the cursor anywhere in the help file.

2.	Choose the Project|Macros command, or press [image] [image] [image] to access the Project Macros dialog box.

To Access the Macro Editor for Topic Macros

1.	Go to the topic where you want the macro to run when opened.

2.	Choose the Topic|Macros command, or press [image] [image] to access the Macro Editor dialog box.

To Create a Hotspot Macro

To create a macro on a graphic, see Putting Hotspots on Pictures.

1.	Select the text to be included in the hotspot.

2.	Choose the Text|Make Macro command, press [image] [image], or click on the [image] toolbar button to access the Make Macro dialog box.

To Edit a Hotspot Macro

To edit a macro on a graphic, see Putting Hotspots on Pictures.  There are two ways to access the Edit Macro dialog box for a text hotspot macro:

Press [image] and click in the hotspot.

Or

1.	Place the cursor in the hotspot.

2.	Choose the Text|Edit Macro or Text|Edit Hotspot command, press [image] [image], or click on the [image] or [image] toolbar buttons.


Add/Assign/Redirect/Find Aliases

This topic contains the following sections:

To Add and Assign an Alias

To Add an Alias for Later Assignment

To Assign an Available Alias

To Redirect an Alias from one Target to Another

To Find the Topic or Target to Which an Alias is Assigned

To use any of these instructions, first choose the Project|Alias command or click on the [image] toolbar button to display the Project Aliases dialog box.  You can work with multiple aliases and targets in this dialog box.  When you select the OK button, all of your actions take effect.  If you select the Cancel button, all of your actions in this dialog box are lost.

To Add and Assign an Alias

1.	In the Target drop-down list box, select the topic or target to which you want to assign an alias.

2.	Type the new alias name in the All Aliases text box.

3.	Press the [image] key or choose the Add button.  The Edit Alias dialog box appears with the alias name in the Context String field.

4.	If an external program or macro will access this alias, enter the appropriate number in the Context Number field of the Edit Alias dialog box.

5.	If you are providing the application programmer with context numbers, you can select or create a context map file.  See Selecting a Context Map File.

6.	Select the OK button.
The alias is added to the Aliases list box for this target and displays as gray text in the All Aliases list box.

To Add an Alias for Later Assignment

1.	Add and assign an alias using any target name in the Target drop-down list box, as described in To Add and Assign an Alias.

2.	Double-click the new alias name in the Aliases list box to remove it from this target's list (or select the name and then the Remove button).  The alias appears as black text in the All Aliases list box for a future assignment.

To Assign an Available Alias

Available aliases are listed in black text in the All Aliases list box.

1.	In the Target drop-down list box, select the topic or target to which you want to assign an alias.

2.	Double-click an available alias name (or select the name and then the Add button).

To Redirect an Alias from one Target to Another

Assigned aliases display as gray text in the All Aliases list box.

1.	In the Target drop-down list box, select the topic or target to which you want to assign the alias.

2.	Double-click the assigned (gray text) alias name in the All Aliases list box (or select the name and then the Add button).  The alias is removed from the previous target and appears in the Alias list for the new target.

To Find the Topic or Target to Which an Alias is Assigned

1.	In the All Aliases list box, select an assigned (gray text) alias.

2.	Select the Find button.  The associated target displays in the Target drop-down list box and the target's alias list, including the selected alias, displays in the Aliases box.


Adding Captions to Window Classes

You can add a caption to a secondary window's title bar or change the title on any window.  The main window's title bar is typically the name of the project as you entered it in the Project Properties dialog box.  If you enter a different name in the Caption field of the main window class, WinHelp uses this name instead of the project name.

To Add a Caption to a Window's Title Bar

1.	Choose the Project|Window Classes command or click on the [image] toolbar button to access the Window Classes dialog box.

2.	Select the name of the window in the Classes list.

3.	Check the Caption box.

4.	Enter the title (up to 50 characters) in the Caption field.
The sample window displays the caption.  Because the font is not scaled to the size of the sample window, the entire caption might not appear in the sample.

5.	Change other attributes if needed and choose the OK button when done.


Adding Keywords to Master List
Adding Keywords to the Master List

This topic contains the following sections:

To Add Keywords to the Master Keyword List

Edit Master Keyword List Dialog Box

To Assign Topic Keywords from the Master Keyword List

To Assign Text Keywords from the Master Keyword List

To Add Keywords to the Master Keyword List

When you add keywords to a topic or to a text location, they automatically are added to the master keyword list.  These instructions explain how to add a keyword to the master list without adding it to a topic.

1.	Choose the Topic|Keywords command, press [image] [image], or click on the [image] toolbar button to access the Topic Keywords dialog box.

2.	Choose the Edit button or press [image] [image] to access the Edit Master Keyword List dialog box.

3.	Choose the New button.
The Enter New Keyword dialog box (a ForeHelp edit/new name dialog box) appears.

4.	In the New Name field, type the new keyword.
ForeHelp adds the keyword in the proper alphabetical order to the master list.

5.	Choose the OK button.
The Edit Master Keyword List dialog box is active and shows the new keyword in its list.

6.	Repeat steps 3 and 4 until you've finished your list.

7.	Choose the Done button.
The Topic Keywords dialog box displays.

8.	Assign keywords from the master list to topics or select the OK button to close the dialog box.

Warning: Selecting the Cancel button in the Topic Keywords dialog box deletes all the changes you just made to the master keyword list.

Edit Master Keyword List Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.

To Assign Topic Keywords from the Master Keyword List

Use these instructions to add keywords from the master keyword list to a topic.

1.	Choose the Topic|Keywords command, press [image] [image], or click on the [image] toolbar button to access the Topic Keywords dialog box.  The title of the current topic displays in the Topic field.

2.	In the Topic drop-down list box, select the topic to which you want to add keywords.

3.	Double-click on a keyword in the All Keywords list box.

4.	Repeat step 3 until you're finished with the topic or select another topic and add keywords.

5.	Choose the OK button.

To Assign Text Keywords from the Master Keyword List

Use these instructions to assign keywords from the master keyword list to a specific location within the current topic.  When the reader selects a text keyword in Search, the Help file displays the topic at the line containing the text keyword.

1.	Place the text cursor where you want to insert a text keyword.

2.	Choose the Test|Insert Text Keyword command or press [image] [image] to access the Keyword in Text dialog box.

3.	In the Keyword list box, double-click a keyword, or select a keyword and choose the OK button.  ForeHelp places a key marker ( [image]) at the location of the text keyword.


Adding Macros

This topic contains the following sections:

To Add a Macro

Macro Editor Dialog Box

ForeHelp facilitates adding macro commands by supplying the correct syntax, supplying standard options for parameters, and checking the syntax when you close the dialog box.

You can add multiple macros to a project, hotspot, or target.  The order in which WinHelp runs the macro commands is important for the correct use of the macros.  For example, CheckItem, which places a checkmark next to a menu item, should run before UncheckItem, which removes the checkmark.  WinHelp runs the macros in the order in which you list them in the macro dialog box.  You can define macros in any order and then use the Up or Down button to move a macro appropriately in the list.

Before you can add a macro to your project, a particular topic, or to a hotspot, you must access the appropriate macro dialog box (See Accessing Macro Dialog Boxes).

To Add a Macro

1.	In the Define Macro Commands section of the macro dialog box, click on the arrow to display the list of WinHelp macros.

2.	Select the command that you want.
If the macro command requires any parameters, the names of the parameters appear in the Command List field and a new field named for the first parameter appears in the Parameters section.  If multiple parameters are required, the Next and Prev buttons are available to enable you to move to the next parameter or to a previous parameter.  If the required parameter is another macro command, see Adding Nested Macros.

To define parameter values:

a)	Select a value from the drop-down list or type an appropriate value in the parameter field.

b)	If the parameter can accept an expression rather than a string, the Add String as Expression (no quotes) check box appears.  Check this box and type the expression in the parameter field.

b)	Choose the Insert button.
The selected option or typed entry appears within the parentheses of the macro command line in the Command List field.  ForeHelp automatically inserts the correct syntax elements, such as quote marks for strings, commas, and parentheses.  If you have used an expression rather than a string and checked the Add String as Expression box, ForeHelp omits the quote marks.  The parameter field now has the name of the next parameter.

c)	Continue to define values for all parameters.

3.	When the entry in the Command List field is correct, select the Add button.
ForeHelp adds the macro to the list in the Current Macro Commands section.

4.	Repeat steps 1 through 3 to define additional macros.

5.	To reorder the macros in the Current Macro Commands list, select a macro to move and then select either the Up button or the Down button to move it to the correct position.

6.	Choose the OK button.

Macro Editor Dialog Box

Note:  Although the Project Macros dialog box is shown, all macro dialog boxes function the same way with the exception of the Hidden button.  This button applies only to hotspots and appears only in the Make Macro and Edit Macro dialog boxes.  Choose the hidden button to display a macro hotspot in plain text.

Click on the parts of the box below where [image] appears for explanations of features.


Adding Nested Macros

Before you can add a macro to your project, a particular topic, or to a hotspot, you must access the appropriate macro dialog box (See Accessing Macro Dialog Boxes).

A nested macro is a macro that is used as a parameter to another macro command.  The parameter name is macro().  When you move to this parameter in the macro dialog box, the parameter field is named Macro and a Macro button appears to the right of the parameter field.

To Add a Nested Macro

1.	In the Define Macro Commands section, click on the arrow to display the list of WinHelp macros.

2.	Select the command that you want.
The names of the parameters appear in the Command List field and a new field named for the first parameter appears in the Parameters section.  If multiple parameters are required, the Next and Prev buttons are available to enable you to move to the next parameter or to a previous parameter.

3.	Select a value from the parameter drop-down list or type an appropriate value in the parameter field.

4.	Choose the Insert button.
The selected option or typed entry appears within the parentheses of the macro command line in the Command List field.  ForeHelp automatically inserts the correct syntax elements, such as quote marks, commas, and parentheses.  The parameter field now has the name of the next parameter.

5.	Repeat steps 3 and 4 to define values for all parameters.

6.	When the current parameter is macro(), select the Macro button to open a second macro dialog box that is identical to the first dialog box.
The second dialog box appears on top of the first dialog box.  The Current Macro Commands lists the item macro().

7.	Repeat steps 1 through 5 to define the nested macro.

8.	Choose the Replace button to replace macro() with the newly defined macro in the Current Macro Commands list.

9.	Choose the OK button.
The second dialog box closes.

10.	In the first dialog box, ensure that the macro command in the Command List field is correct.

11.	Choose the Add button.
ForeHelp adds the defined macro to the Current Macro Commands list.

12.	Choose the OK button.


Adding Text Keywords

This topic contains the following sections:

To Insert Text Keywords Using Existing Text

To Insert New or Existing Text Keywords

Keyword in Text Dialog Box

Text keywords lead the reader directly to the line containing the related information.  To lead the reader to the start of the topic containing the information, see Adding Topic Keywords.

You can select text within your topic and make it a text keyword.  You can add new keywords to the master keyword list or select keywords from the master list to lead to a specific location within the topic.  When you have text detail turned on in the Preferences dialog box, ForeHelp shows the location of text keywords with a key marker ( [image]).  When you place the cursor on the key marker, the right field of the status line displays the keyword.  If there are multiple keywords at the marker, use the [image] or [image] key to display each keyword in the status line.

You cannot use the same keyword as a topic keyword and a text keyword in the same topic.  You cannot assign the same keyword to two text locations within the same topic.  When you assign a text keyword in a topic, ForeHelp shows this keyword in gray text in all displays of keyword lists for this topic.

To Insert Text Keywords Using Existing Text

Use these instructions to make selected word(s) into text keywords.

1.	In the topic text, select the word(s) that you want to make into a text keyword.

2.	Choose the Text|Insert Text Keyword command or press [image] [image] to access the Keyword in Text dialog box.  The selected text appears in the Keyword text field.

3.	Edit the selected text in the Keyword field, if needed.

4.	Choose the OK button.  If you have text detail turned on, a small key marker appears to the left of the text that you had selected.

To Insert New or Existing Text Keywords

You can enter a new keyword or select any keyword from the master keyword list to use as a text keyword.

1.	Place the text cursor where you want to insert a text keyword.

2.	Choose the Text|Insert Text Keyword command or press [image] [image] to access the Keyword in Text dialog box.  The Keyword text field is blank.

3.	In the Keyword field, type in the new keyword or the first few letters of an existing keyword.  As you type letters, the Keyword list scrolls to display the closest match.

4.	You can select an entry from the master keyword list by clicking on it.  The selected keyword is highlighted in the list and appears in the Keyword field.

5.	When the Keyword field contains the correct entry, choose the OK button.  If you have text detail turned on, a small key ( [image])appears at the cursor location.

Keyword in Text Dialog Box

Choose the Text|Insert Text Keyword command or press [image] [image] to access the Keyword in Text dialog box.

Click on the parts of the box below where [image] appears for explanations of features.


Adding Topic Keywords

This topic contains the following sections:

To Insert Topic Keywords

To Make the Topic Title into a Keyword

To Add New or Existing Topic Keywords

Topic Keywords Dialog Box

Topic keywords lead the reader to the start of the topic that contains the related information.  To lead the reader to the specific line containing the information, see Adding Text Keywords.

ForeHelp lets you insert keywords while you're editing text within a topic, or you can add them later using the Topic Keywords dialog box.  Each time you insert or add a keyword to a topic list, ForeHelp adds the keyword to the master list.  You can also create a master keyword list for your help project and assign keywords to topics from the master list.  You can use the Find feature to locate selected text and add the selected text as a keyword to the topic in which it is found.

To Insert Topic Keywords

You can specify text within a topic to be used as a keyword.  ForeHelp adds the selected text to the master keyword list and to the list for this topic.  The selected text in the topic is not connected to the keyword lists.  You can change or delete the text without affecting the keyword lists.

1.	While in a topic, select the text you want to use as a keyword.

2.	Choose the Text|Make Topic Keyword command, press [image] [image], or click on the [image] toolbar button.  ForeHelp adds the selected text to the master keyword list and to the list for this topic.

To Make the Topic Title into a Keyword

When you create a new topic, check the Keyword box.  ForeHelp automatically assigns the topic title as a keyword to this topic and adds it to the master keyword list.

To Add New or Existing Keywords to a Topic

You can add new keywords to topics without displaying the topic in your workspace.  You can also select existing keywords from the master keyword list to add to any topic.

1.	Choose the Topic|Keywords command, press [image] [image], or click on the [image] toolbar button to access the Topic Keywords dialog box.  The title of the current topic displays in the Topic field.

2.	In the Topic drop-down list box, select the topic to which you want to add keywords.

3.	Click in the All Keywords text box.

4.	Type in the new keyword or the first few letters of an existing keyword.  As you type letters, the master keyword list in the All Keywords box scrolls to display the closest match.  You can select an entry from the master keyword list by clicking on it.

5.	Press [image] or select the Add button.
The keyword appears in the Keywords List for this topic and in the All Keywords master list.
Note:  You can add an existing keyword by double-clicking the keyword in the All Keywords list box.

6.	Continue entering keywords until you're finished with the topic or select another topic and add keywords.  Keywords are added to the topic as well as to the master keyword list.

5.	Choose the OK button.

Topic Keywords Dialog Box

Choose the Topic|Keywords command, press [image] [image], or click on the [image] toolbar button to access the Topic Keywords dialog box.

Click on the parts of the box below where [image] appears for explanations of features.


Adding and Removing Bullet Pictures

This topic contains the following sections:

To Add Bullet Pictures to the Master List

To Remove Bullet Pictures from the Master List

Add Bullet Picture Dialog Box

ForeHelp provides several default bullet pictures.  You can create your own designs and add them to the master bullet list.  ForeHelp maintains this list in the FOREHELP.INI file.  Whenever you add or delete a bullet picture while in one project, ForeHelp automatically updates the FOREHELP.INI file.  The master bullet list is available to all of your projects.

Important:  ForeHelp's bullet pictures are black graphics on a small white background.  If you insert this bullet in a topic or banner that has a colored background, the white background of the bullet picture is visible.  You can use a bitmap editor, such as Windows' Paintbrush, to change the background color of the bullet picture to match your help file's colors.

To Add Bullet Pictures to the Master List

1.	Create a bullet picture using an appropriate application.  The bullet picture can be a .BMP, .WMF, .MRB, or .SHG file.

2.	Choose the Text|Insert Bullets command to access the Bullet And Numbering dialog box.

3.	Select the Bullet option.  The bullet list box appears with Add and Remove buttons.

4.	Choose the Add button.  The Add Bullet Picture dialog box appears.

5.	Select the drive, directory, and file name of the file containing the bullet that you want to add.  The contents of the file displays in the sample box in the lower right corner of the dialog box.

6.	In the Bullet Name field, enter a name for the bullet.  This is the name that will appear in the ForeHelp bullet list.  This is a required entry.

7.	Choose the OK button.  The Bullet And Numbering dialog box reappears with the new bullet name highlighted in the list of bullets.  ForeHelp has updated the FOREHELP.INI file with the new bullet picture.

8.	Repeat steps 2 through 7 to add other bullet pictures to the list.

9.	Choose OK to insert the selected bullet into your topic or choose the Cancel button to close the dialog box.  The added bullets remain in the list when you choose Cancel.

To Remove Bullet Pictures from the Master List

1.	Choose the Text|Insert Bullets command to access the Bullet And Numbering dialog box.

2.	Select the Bullet option.  The bullet list box appears with Add and Remove buttons.

3.	Select a bullet picture from the list box.

4.	Choose the Remove button.  A message displays asking you to confirm the deletion of this bullet picture.

5.	Choose the Yes button to delete or the No button to cancel the deletion.  If you choose Yes, ForeHelp removes the bullet picture from the list and from your FOREHELP.INI file.

5.	Choose the Cancel button to close the dialog box.

Add Bullet Picture Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Adding, Changing, Deleting Map Files

This topic contains the following sections:

Adding a New Context Map File

Changing a Context Map File Name

Deleting a Context Map File

Before you can assign context numbers to context map files, you must either select an existing file or create a new file and then add the file to your project's list of files.  ForeHelp enables you to do this from any dialog box that provides context information, such as Topic Properties, Insert Target, Edit Alias, and Context Mapping dialog boxes.  The Context Mapping dialog box enables you to create new files in your project's directory, change the names of the files, and delete files from the project list.  See the remaining sections of this topic for instructions.

The other dialog boxes provide a Context Map File button that accesses a standard Windows file open dialog box, in which you can select any file available to your computer or create a new file located in any other drive or directory.  You cannot delete or change the names of files on the project's list from these dialog boxes.  See Selecting a Context Map File for instructions on using the Context Map File button.

Adding a New Context Map File

You can use the Context Mapping dialog box to add a new context map file name to your project and to associate a topic's context number with this file.  When you build your project, ForeHelp creates this file and places it in your project's build directory.

1.	Choose the Project|Context Mapping command or click on the [image] toolbar button to access the Context Mapping dialog box.

2.	In the Topic field, select the context string of the topic whose context information you want to place in the new file.

3.	In the Context Number field, enter or select a context number, if there isn't a number assigned.

4.	Choose the New button.
The Enter New Context Map File Name dialog box appears.  This is a ForeHelp edit/new name dialog box.

5.	In the New Name field, enter the name of the new map file.

6.	Choose the OK button.
The Context Mapping dialog box is now active and displays the new map file name in the list of map files.

7.	Choose the OK button.
ForeHelp adds the new file to your project list and closes the dialog box.  The next time you open this dialog box, this file will be listed in the Context Map File list.

Changing a Context Map File Name

You can change the name of a context map file in your project's list.  When you build your project, ForeHelp deletes the file with the old name and creates the new file in your project's directory.

1.	Choose the Project|Context Mapping command or click on the [image] toolbar button to access the Context Mapping dialog box.

2.	In the Context Map File list, select the map file that you want to change.

3.	Choose the Change button.
ForeHelp displays the Edit Context Map File Name dialog box, a standard ForeHelp edit name dialog box.

4.	In the New Name field, enter the new name for the map file.

5.	Choose the OK button.
ForeHelp closes the Edit Context Map File Name dialog box and replaces the name of the selected map file with the new name in the Context Map File list.

Deleting a Context Map File

If you delete a context map file from the project list, ForeHelp deletes this file when you build the project.

1.	Choose the Project|Context Mapping command or click on the [image] toolbar button to access the Context Mapping dialog box.

2.	In the Context Map File list, select the map file that you want to delete.

3.	Choose the Delete button.
ForeHelp removes the file name from your project's list and from the Context Map File list.


Alias

A special kind of target that can be redirected to any topic or target you choose.


Applying Styles

This topic contains the following sections:

To Apply a Style Using the Format Bar

To Apply a Style Using a Style Accelerator Key

To Apply a Style Using the Apply Style Dialog Box

Apply Style Dialog Box

You apply a style to a paragraph.  If you apply a style and see no changes or only partial changes, there may be character or paragraph format changes applied to the text outside the assigned style.  Such local changes always override style settings that use the same options.  To reverse such local changes when trying to apply a style, select the text, and press [image] [image] or click on the [image] toolbar button.

To Apply a Style Using the Format Bar

The format bar appears above the topic workspace in the ForeHelp window, unless you set the ForeHelp Preferences to omit its display.  See Using the Format Bar for a description of each item in the bar and instructions for displaying it or removing it from the ForeHelp window.

1.	Place the cursor in the paragraph to which you want to apply a style.  To apply the same style to contiguous paragraphs, select all or part of each paragraph at the same time.

2.	Click on the arrow next to the style name field to display the list of defined styles.

3.	Select a style name.
ForeHelp applies the style to the selected paragraphs.

To Apply a Style Using a Style Accelerator Key

If you assigned an accelerator key when you created or edited a style, you can use the key to apply a style quickly.

1.	Place the cursor in the paragraph to which you want to apply a style.  To apply the same style to contiguous paragraphs, select all or part of each paragraph at the same time.

2.	Press [image] + the number key of the accelerator.

To Apply a Style Using the Apply Style Dialog Box

1.	Place the cursor in the paragraph to which you want to apply a style.  To apply the same style to contiguous paragraphs, select all or part of each paragraph at the same time.

2.	Choose the Format|Apply Style command, press [image] [image], or click on the [image] toolbar button.

ForeHelp displays the Apply Style dialog box.

3.	In the Name list box, select the style you want to apply.
When you select a name, the description box lists the attributes defined for this style, and ForeHelp identifies the paragraphs using that style in your topic by highlighting them along the left edge of the screen.

4.	Choose the OK button.

Apply Style Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Assigning Topics to a Browse Sequence
Assigning and Viewing Topics in a Browse Sequence

This topic contains the following sections:

To Add Topics to a Browse Sequence

To View Topics in a Browse Sequence

You can assign a topic to only one browse sequence.  ForeHelp displays an unassigned topic name in black print and an assigned topic name in gray print in the All Topics list in the Project Browse Sequences dialog box.  If you add a gray topic name to a browse sequence, ForeHelp adds this topic to the current browse sequence and removes it from the previous browse sequence.

To Add Topics to a Browse Sequence

1.	Choose the Project|Browse Sequences command, press [image] [image] [image], or click on the [image] toolbar button to access the Project Browse Sequences dialog box.

2.	From the Sequence drop-down list box, select a browse sequence name.  To add a new name to this list, see Creating and Modifying a Sequence Name.

3.	Double-click on the desired topic name in the All Topics list box (or select the name and then click on the Add button).
The topic name is added to the Topics list box and appears in gray type in the All Topics list box.

4.	Repeat step 3 to add the topics needed for this browse sequence.  If the topic is already assigned to another browse sequence, it is removed from that sequence and inserted in the new sequence.

5.	Repeat steps 2 and 3 to add topics to additional browse sequences.

6.	Choose the OK button to save the browse sequence definitions.  Selecting Cancel removes all of the changes you made since you first opened the Project Browse Sequences dialog box.

To View Topics in a Browse Sequence

Select the browse sequence you want to view from the Sequence drop-down list box.  The associated topics are listed, in order, in the Topics list box.


Backing Up a Project

This topic contains the following sections:

To Make a Backup

Backup Project Dialog Box

When you create a backup file of your project, you have the option of including graphic files and/or baggage files.  Making a backup file is faster and the file is smaller if you do not include these files.

To Make a Backup

1.	Choose the File|Backup command or the [image] toolbar button to access the Backup Project dialog box.  The List Files of Type box displays ForeHelp Backup File, which is the only option..

2.	Select the Directory and Drive where you want to store the backup file.

3.	Accept the default file name, type in a file name, or select a file name from the list of backup files.  If you select an existing file name, ForeHelp overwrites this file.

4.	If you do not want the graphic files included in the backup file, clear the Include Graphic Files check box.

5.	If you do not want the baggage files included in the backup file, clear the Include Baggage Files check box.

6.	Choose the OK button.

The status line displays the names of the files as they are backed up.  It displays messages if ForeHelp cannot find the files to back up.

Backup Project Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Backups

ForeHelp's backup facility makes a single file archive from your entire project in a compressed format.  The backup file has an .FHB extension.  You can choose to include graphic files and/or baggage files with the other project files.  Backup is useful for

Safety - If anything happens to your current database, you can open a previous backup.  As with any application, it is recommended that you back up often.

Moving a project - You can open a backup on another computer and restore all files in their correct directory structure.

Saving your project in different stages - You can keep a copy of your project in various stages of development.

Storing a project - After completing a project, you can create a backup file and delete the database and graphics files that comprise the project.


Baggage

This topic contains the following sections:

To Add Baggage Files

To Remove Baggage Files

Baggage Dialog Box

Baggage refers to external files that you want to include in the compiled help project.  For example, DLLs that you embed or use in macros can call additional files when they run.  The DLL itself is not a baggage file, but the files it calls are considered baggage.

You can create a list of baggage files, which ForeHelp then automatically includes when it builds your project.

Important:	When you use a DLL in your help file, you must distribute the .DLL file with your .HLP file.  If you do not add the external file(s) as baggage to your .HLP file, then you must also distribute the external files with the .DLL and .HLP file.

To Add Baggage Files

1.	Choose the Project|Baggage command or click on the [image] toolbar button to access the Baggage dialog box.

2.	Choose the Add button.  The Add Baggage dialog box, a standard Windows file open dialog box, appears.

3.	Select Drive, Directory and File Name of the file you want to add as baggage and select the OK button.
The Baggage dialog box redisplays with the selected name listed in the Files box.

4.	Continue adding additional files.

5.	Choose the OK button.

To Remove Baggage Files

1.	Choose Project|Baggage to access the Baggage dialog box.

2.	In the Files list box, select the file you want to remove from the list.

3.	Choose the Remove button.

4.	Continue selecting and removing files as needed.

5.	Choose the OK button.

Baggage Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Baggage Files

Baggage files are external files needed to run DLL routines and macros that are compiled into the .HLP file.  See Baggage, or choose the Project|Baggage command.


Banner

ForeHelp Window

The banner is a nonscrolling area at the top of a topic in which you can enter a topic title.  As the reader scrolls through the topic text, the banner remains in view.  Turn the banner on and off for a topic in the Topic Properties dialog box.


Banner Base Style

The Banner Base style is the default style that is applied to all banner text where you haven't explicitly applied a style.  The Banner Base style formats are: Arial 18 point, single line spacing, left justification, and left tabs set every 1/2".  You can change the Banner Base style in the Edit Style dialog box.


Banner Definition
Banner or Nonscrolling Area

A banner or nonscrolling area is a region at the top of a topic with a horizontal line separating it from the topic's main text.  In long topics, scroll bars appear beneath the banner to enable the reader to scroll through the topic text.  The banner remains visible when you scroll through the body of the topic.  The banner area can contain text, such as the topic title, and/or graphics.  You can turn it on or off for the current topic by using the Banner check box in the Topic Properties dialog box.


Banners

This topic contains the following sections:

To Create a Banner

To Delete a Banner

To Assign Color to Banners

A banner is a nonscrolling area that appears above the line at the top of a topic.  Typically, topic titles appear in the banner so that the title remains visible as the reader scrolls through the topic text.  Banners can contain text, graphics, and hotspots, and can have a background color different from the topic window.  ForeHelp adjusts the height of the banner to accommodate the size of its text or graphics and any paragraph definitions.

Warning:  Do not assign banners to topics that are popup targets because WinHelp displays only the banner in the popup window.

To Create a Banner

You assign banners to topics using the Topic Properties dialog box.  You can assign a banner when you create the topic or at any time.

1.	Move to the topic that you want to have a banner or create a new topic.  See Creating New Topics.

2.	Choose the Topic|Properties command, press [image] [image], or click on the [image] toolbar button to access the Topic Properties dialog box.

3.	Check the Banner box.

4.	Check the Copy Title to Topic to place the title in the banner.

5.	Choose the OK button.
ForeHelp places a banner at the top of the current topic.

To Delete a Banner

1.	Move to the topic whose banner you want to delete.

2.	Choose the Topic|Properties command, press [image] [image], or click on the [image] toolbar button to access the Topic Properties dialog box.

3.	Clear the Banner box.

4.	Choose the OK button.
ForeHelp removes the banner from the top of the current topic.

To Assign Color to Banners

You can assign a color to all the banners within a specific window class.  The banner does not show a color in the ForeHelp window.  To see the color, view the sample in the Window Classes dialog box or use Test mode.

1.	Choose the Project|Window Classes command or click on the [image] toolbar button to access the Window Classes dialog box.

2.	In the Class list, select the name of the window class for which you want the banner to have a color.  The primary window class is named main.

3.	In the Colors section, check the Banner box.

4.	Choose the Change button below the Banner box.
The Color dialog box appears.

5.	Select the color you want for the banner.

6.	Choose the OK button in the Color dialog box.
The sample window in the Window Classes dialog box displays your selected color.

7.	Choose the OK button in the Window Classes dialog box.


Base Style

The Base style is the default style that is applied to all paragraphs where you haven't explicitly applied a style.  The Base style formats are: Arial 12 point, single line spacing, left justification, and left tabs set every 1/2".  You can change the Base style through the Edit Style dialog box.


Browse Sequence

A browse sequence is a series of related topics that you link together in a specific order.  The reader can move through the browse sequence, displaying each topic in turn, using the browse buttons in the help window.  In ForeHelp, you can move through the topics in the browse sequence using the [image] [image] or [image] [image] keys, or clicking on the [image] or [image] toolbar buttons.  See Browse Sequences.


Browse Sequences

Browse sequences let you assign topics to a named group of related topics in a specific order.  In this manner, you can lead your reader through a series of topics in a predefined order.  When you define one or more browse sequences for your help project, ForeHelp automatically adds the BrowseButtons command to the list of project macros.  In Test mode or in WinHelp, two browse buttons appear on the button bar.  Click the forward (>>) or backward (<<) buttons to move through the sequence.  Browse buttons are enabled when there are additional topics in the browse sequence in the given direction.

When the current topic is part of a browse sequence, ForeHelp enables menu commands, toolbar buttons, and shortcut keys that allow you to move forward or backward through the browse sequence in the ForeHelp window.  To move forward, press the [image] [image] keys, click on the [image] toolbar button, or choose the Topic|Next command.  To move backward through the sequence, press the [image] [image] keys, click on the [image] toolbar button, or choose the Topic|Previous command.

You can assign a topic to only one browse sequence.  If you assign it to another sequence, ForeHelp removes it from the first browse sequence and adds it to the second.

The Reporter can display and print the name of the assigned browse sequence for any or all topics.  It can also display and print an alphabetical list of all browse sequence names in your project.  The Navigator can also display the browse sequence for a topic and show its location within the sequence.


Build

Build is the process in which ForeHelp creates the .RTF and .HPJ files.  These files are then used to compile the help project.  To access Build, choose the Project|Build command, press [image], or click on the [image] toolbar button.  See Build and Compile.


Build Directory Dialog Box

This topic contains the following sections:

To Select an Existing Directory

To Create a New Directory

Build Directory Dialog Box

ForeHelp displays the Build Directory dialog box when you select the Build Directory button in the Project Paths dialog box.  You can select or create a directory in which ForeHelp places the .HPJ and .HLP files when you build and compile your project.

To Select an Existing Directory

1.	In the Directories and Drives fields, select the drive and directory where you want ForeHelp to place the files it creates during the build process.

2.	Choose the OK button.
The selected drive and directory path appears in the Build Directory field of the Project Paths dialog box.

To Create a New Directory

1.	Choose the Create button to access the Create Directory dialog box.

2.	Enter the name of the directory you want ForeHelp to create.

3.	Choose the OK button.  The Build Directory dialog box is now active.

4.	Choose the OK button.

Click on the parts of the box below where [image] appears for explanations of features.


Build and Compile

This topic contains the following sections:

How to Use the Build Dialog Box

Build Dialog Box

You can build and/or compile your help project at any time.  The build process creates project (.HPJ) and text (.RTF) files, which are used as input to the WinHelp compiler.  You can open the .HPJ file with ForeHelp and other WinHelp authoring tools and import the .RTF file(s) to word processing packages.  You can control where ForeHelp places the .HPJ file, the .RTF file(s), and the graphics files using the Project Paths dialog box.  You can build a subset of the topics in your help project or create multiple .RTF files.  See Creating Rich Text Format (.RTF) Files.

During the build process, ForeHelp detects conditions that may prevent your final help file from displaying correctly or that cause errors during compilation.  ForeHelp can locate the topic containing the error condition so that you can fix it.  See Project Build Status window for more information.

The WinHelp compiler creates the final help (.HLP) file.  It also detects certain error conditions.  You can view the completed help file by choosing the Project|WinHelp command, or the [image] toolbar button.  You can also use Test mode to view and test your help application without building and compiling.

To Use the Build Dialog Box

The Build dialog box allows you to build the .HPJ and .RTF files only, to compile existing .HPJ and .RTF files, or to build and compile the entire project at one time.

1.	Choose the Project|Build command, press the [image] key, or select the [image] toolbar button.  The Build dialog box appears.

2.	Select the options for this build.  For an explanation of each option, click on the option on the dialog box below.

3.	Select the OK button.  The Project Build Status window appears to display the progress, warnings, and errors found during the build and compile process.  When the build and/or compile has completed, this window displays the appropriate message.  You can keep the window open to locate and correct errors or close it using the standard window controls.

If there are errors during the build process and you had selected the Build All and Compile option, ForeHelp displays a message asking if you want to compile the project.

Build Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Bullet and Number Examples

This topic contains the following examples:

Bullet List Using Base Style and No Indent Option

Bullet List Using Hanging Indent Option

Bullet List Using List Style

Single Level Numbered List

Standard Multiple Level Numbered List

Outline-Style List

Example: Bullet List Using Base Style, No Indent Option, and Diamond Bullet

This example's Base style is defined with a left margin at zero, first line indent at zero, and a right margin at the right edge of the window.

The No Indent option retains the paragraph style and aligns the subsequent lines of a paragraph underneath the bullet or number.

Example: Bullet List Using Hanging Indent Option and Arrow Bullet

This example's style, before the bullet insertion, was defined with a left margin at zero, no first line indent, a right margin at the right edge of the window, and no space between paragraphs.

The Hanging Indent option adjusts the first line indent of the paragraph so that subsequent lines of the paragraph align beneath the first word after the bullet.

Example: Bullet List Using List Styles and Large Square Bullet

This example's style, before the bullet insertion, was defined with a left margin at zero, no first line indent, a right margin at the right edge of the window, and no space between paragraphs.

The Use List Styles option uses the ForeHelp default List styles.  In a single level list, such as bullets, ForeHelp uses the List1 style, which places the bullet at the left edge of the window, inserts .25" space between the bullet and the text, and aligns the text of the paragraph underneath the first word of the paragraph.

Example: Single Level Numbered List

See Numbering Single Level Lists for instructions on how to create this type of list.

1.	You can use single level lists for steps.

2.	As you insert steps, you can renumber the list by selecting the numbered lines and reinserting a numbered list.

Example: Standard Multiple Level Numbered List

See Numbering Multiple Level Lists for instructions on how to create this type of list.

1	Multiple Level Lists

1.1	In standard numbering, each subitem retains the number of the parent item.

1.1.1	ForeHelp uses numbers only.

1.1.2	You can have up to three levels.

1.2	In outline style, subitems typically use a different numbering style.

1.2.1	You can select the numbering style for each level.

1.2.2	You can change the separator for each level.

Example: Outline-Style List

See Numbering Multiple Level Lists for instructions on how to create this type of list.

I.	Multiple Level Lists

A)	In standard numbering, each subitem retains the number of the parent item.

1:	ForeHelp uses numbers or letters.

2:	You can have up to three levels.

B)	In outline style, subitems typically use a different numbering style.

1:	You can select the numbering style for each level.

2:	You can change the separator for each level.


Bullets and Numbered Lists

This topic contains the following sections:

Bullet Features

Numbering Features

Bullets And Numbering Dialog Box

ForeHelp can insert bullets into lists and automatically number steps for you, with up to three levels of substeps.  You can choose to use your own paragraph style, create a hanging indent style, or use ForeHelp's default List styles.  You can edit the default styles as you would any style definition.

Bullet Features

ForeHelp includes a variety of bullet pictures.

You can add your own bullet pictures.

ForeHelp remembers the last bullet (or number selection) when you insert new bullets using the [image] toolbar button.

For instructions on inserting bullets, see Inserting Bullets.

Numbering Features

You can number steps in single levels or with substeps (multi-level numbering).

For each level, you can choose the type of number and the separator.

You can select the number at which ForeHelp is to start inserting numbers.

You can easily modify or renumber previously numbered or bulleted lists.

For instructions, see Numbering Single Level Lists or Numbering Multiple Level Lists.  For examples of single and multiple level lists, see Bullet and Number Examples.

Bullets And Numbering Dialog Box

The Bullets And Numbering dialog box changes depending on whether you select Bullet, Single Level, or Multi Level.  See one of the following for details on each variation of the dialog box:

Inserting Bullets: Bullets And Numbering Dialog Box

Numbering Single Level Lists: Bullets And Numbering Dialog Box

Numbering Multi Level Lists: Bullets And Numbering Dialog Box


C: Commands

ForeHelp
Table of Contents

What's New in Version 2.0

Introduction

How to Work with

Project Management Tools

Commands

File Menu

Edit Menu

Text Menu

Format Menu

Project Menu

Topic Menu

Tools Menu

Help Menu

Reference


C: How to Work with...

ForeHelp
Table of Contents

What's New in Version 2.0

Introduction

How to Work with..

Aliases

Backups

Baggage

Banners (nonscrolling area)

Browse Sequences

Build and Compile

Bullets and Numbered Lists

Context-Sensitive Help

Embedded Windows and Dynamic Link Libraries

Find and Replace

ForeHelp Projects

ForeHelp Window

Help Browser

Jumps and Popups

Keywords and Search

Macros

Manual Generation

Paragraphs

Pictures

Preferences

Print

Spell Check

Styles

Table of Contents

Tables

Targets

Templates

Test Mode

Text Editing

Text from Other Files (Importing)

Thesaurus

Topics

Window Classes

Project Management Tools

Commands

Reference


C: Introduction

ForeHelp
Table of Contents

What's New in Version 2.0

Introduction

What Is ForeHelp

ForeHelp Help Conventions

ForeHelp Concepts & Terms

Understanding ForeHelp Project Files

Steps to Creating Your Help Project

Testing Your Project

How to Work with

Project Management Tools

Commands

Reference


C: Project Management Tools

ForeHelp
Table of Contents

What's New in Version 2.0

Introduction

How to Work with

Project Management Tools

Grapher

Navigator

Reporter

Commands

Reference


C: Reference

ForeHelp
Table of Contents

What's New in Version 2.0

Introduction

How to Work with

Project Management Tools

Commands

Reference

Glossary

Keyboard Shortcuts


Cell

A cell is one portion of a table representing the intersection of a row and column.  A cell is indicated by gridlines around it when text detail is turned on in the Preferences dialog box.  See Tables.


Change/Remove/Delete Aliases

This topic contains the following sections:

To Change the Name, Context Number, or Context Map File of an Alias

To Remove an Alias Assignment from a Target

To Delete an Alias from the All Aliases List Box

To use any of these instructions, first choose the Project|Alias command or the [image] toolbar button to display the Project Aliases dialog box.  You can work with multiple aliases and targets in this dialog box.  When you select the OK button, all of your actions take effect.  If you select the Cancel button, all of your actions in this dialog box are lost.

To Change the Name, Context Number, or Context Map File of an Alias

1.	In the All Aliases list box, select the name of the alias that you want to change.

2.	Select the Edit button.  The Edit Alias Dialog Box appears.

3.	To change the name of the alias, enter a new name in the Context String field.

4.	Make the appropriate changes to the context number or context map file.  See Selecting a Context Map File.

5.	Select the OK button.  If you changed the alias' context string, the new name replaces the old name and displays in the All Aliases list in the Project Aliases dialog box.

To Remove an Alias Assignment from a Target

1.	In the All Aliases list box, select the alias name.

2.	Select the Find button.  The target name to which the selected alias is assigned appears in the Target drop-down list box and the target's alias list appears in the Aliases box.

3.	Double-click the alias name in the Aliases list box (or select the name and then the Remove button).  The name becomes available (black text) in the All Aliases list box and is deleted from the Aliases list box.

To Delete an Alias from the All Aliases List Box

1.	In the All Aliases list box, select the alias name.

2.	Select the Delete button.  The alias is deleted from the All Aliases list box and from the project.


Changing Keywords

This topic contains the following sections:

To Change the Wording of a Keyword

To Check Spelling of Keywords

You can change the wording and check the spelling of keywords.  To change the assignment of topic or text keywords, you must remove the keywords from the topic list or text location and add a new keyword.  See Deleting Keywords, Adding Topic Keywords, and Adding Text Keywords.

To Change the Wording of a Keyword

You can change the spelling or punctuation of a keyword in the master keyword list.  The change is automatically applied to all topics and text location containing the keyword.

1.	Choose the Topic|Keywords command, press [image] [image], or click on the [image] toolbar button to access the Topic Keywords dialog box.

2.	Choose the Edit button or press [image] [image] to access the Edit Master Keyword List.

3.	In the Keywords box, select the keyword you want to change.

4.	Choose the Change button.  The Edit Keyword dialog box appears, displaying the selected keyword in the Old Name and New Name fields.

5.	Click in the New Name field.

6.	Edit the keyword as needed.

7.	Choose the OK button.  The Edit Master Keyword List dialog box reappears with the corrected entry.  ForeHelp updates all topics that reference this keyword.

8.	Choose the Done button.  The Topic Keywords dialog box reappears.

9.	Choose the OK button.

Warning: Selecting the Cancel button in the Topic Keywords dialog box deletes all the changes you just made to the master keyword list.

To Check Spelling of Keywords

You can use ForeHelp's Spell Check feature to check spelling of all keywords in the master list.

1.	Choose the Tools|Spell Check command or click on the [image] toolbar button to access the Spelling Options dialog box.

2.	In the Look Where section, check the Keywords & Titles box.

3.	Choose the OK button.  ForeHelp checks the spelling of the keywords and titles in your entire project.  The Check Spelling dialog box appears if any spelling errors are found.


Changing Print Setup

This topic contains the following sections:

To Change Printer Settings Permanently

To Change Printer Settings for the Current Print Job

Print Setup Dialog Box

You can change the basic parameters for printing all of your ForeHelp projects, for printing only the currently selected topics, or for printing the current Grapher or Reporter output.  The basic print parameters are the printer that you are using, the orientation of the topic on the paper, paper size, and the location of the paper tray.

Display the Print Setup dialog box to change permanently the basic parameters for printing your ForeHelp projects .  To change the settings only for the current print job, access Print Setup from the Print Topics dialog box.

To Change Printer Settings Permanently

When you set parameters using these instructions, the parameters apply to all print jobs in ForeHelp.

1.	Choose the File|Printer Setup command to access the Print Setup dialog box.

2.	Make any option changes you want.

3.	Choose the OK button.

To Change Printer Settings for the Current Print Job

Any changes made using these instructions apply only to the current print job.

1.	Choose the File|Print Topics command to access the Print Topics dialog box; or choose the File|Print command within Grapher or Reporter to access the Print dialog box.

2.	Choose the Setup button to access the Print Setup dialog box.

3.	Change the parameters as desired.

4.	Choose the OK button.  The Print Topics dialog box is again available.

Print Setup Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Changing Text Color

You can change color for selected text or assign a color to a paragraph style.  Be careful when selecting a color.  The basic 16 VGA colors are available on most readers' computers.  If the reader's computer is not able to display your selected color, Windows substitutes the closest color available.  That color can be white, in which case, the characters won't display when the background color is white.

To Change Text Color

1.	Select text that you want to change or insert the cursor where you want to start typing text with the new color.

2.	Choose the Format|Character command, press [image] [image], or click on the [image] toolbar button to access the Character Format dialog box.

3.	Choose the Color button to access the Color dialog box.

4.	Select a color from the basic VGA colors or choose the Define Custom Colors button to expand the Color dialog box.

5.	Choose the OK button.
The Character Format dialog box is now active and displays the selected color in the Sample box.

6.	Choose the OK button.


Changing Topic Properties

After you create a topic, you can change topic names or context strings, add or change context numbers or context map files, add or remove a banner from a topic, or specify a different .RTF file.

When you change a topic's context string, ForeHelp automatically updates all hotspots that reference the topic with the new context string.

IMPORTANT	Use caution when changing the context number and/or context map file if any external programs use these items for context-sensitive help.  Also use caution when changing the context string, if another help file has an interfile jump or popup to this topic.  If you change these items without also changing the information in the external programs or help file, the program cannot locate the appropriate target.  When your reader attempts to use a hotspot that leads to the topic's old context number, an error message displays indicating that the help file does not exist.

To Modify Topic Properties

1.	Go to the topic you want to change.  (See Moving Among Topics.)

2.	Choose the Topic|Properties command, or press [image] [image], or click on the [image] toolbar button to access the Topic Properties dialog box.

3.	Make the desired changes.  If you change the context string, ForeHelp automatically adjusts all jumps and popups to this target in the current project.

4.	Choose the OK button.


Changing Window and Banner Colors

By default, ForeHelp creates windows that have a white background for the topic text and white banners.  You can change both colors in the Window Classes dialog box.  Use one of the basic 16 VGA colors, which are available on most computers.  If the selected color is not available, Windows substitutes a color, which may be white or black (and which might not be visible on a white background).

Although the banner color is associated with a window class, the banner itself is associated with each topic and not with the window class.  To add banners to topics, see Banners.

Important: When you assign a color to a banner or to a window background, test the effect of inserting your pictures against the background.  For example, some pictures, such as ForeHelp's bullet pictures, have a white background, which is invisible on a white window.  On a colored window or banner, the picture might not appear as you planned.  You can use test mode to check the appearance of your pictures on a colored background.

To Change Window and/or Banner Color

1.	Choose the Project|Window Classes command or click on the [image] toolbar button to access the Window Classes dialog box.

2.	In the Classes field, select the name of the window class you want to modify.

3.	Check the Background box to change the window color and the Banner box to change banner color.  ForeHelp displays the current colors in the Sample box.

4.	Choose the appropriate Change button.  The Color dialog box appears.

5.	Select the desired color or choose the Define Custom Color button in the Color dialog box.  The sample window reflects the new colors.

6.	Change other attributes for this window if desired and choose OK when done.


Changing or Deleting Jumps and Popups

This topic contains the following sections:

To Change Jump or Popup Text

To Move or Copy a Jump or Popup

To Change a Jump's Target or Modify Its Properties

To Change a Popup's Target or Modify Its Properties

To Delete a Hotspot

Edit Jump or Edit Popup Dialog Box

To Change Jump or Popup Text

Use these instructions for changing the wording of a hotspot.

1.	Place the cursor inside the hotspot.

2.	Use all the normal word processing features to remove, replace, and add text, without deleting the hotspot.

To Move or Copy a Jump or Popup

Use these instructions to move a hotspot from its current location to a new location in the same topic or in another topic.  You can also copy a hotspot to leave it in its current location and use it in a new location.

1.	Select the jump or popup including the corner brackets.  Corner brackets are visible with text detail turned on.

2.	Choose the Edit|Cut command to remove the hotspot from this location or choose the Edit|Copy command to copy the hotspot.  See Cut, Copy, and Paste for instructions.

3.	Place the cursor at the new location.

4.	Choose the Edit|Paste command to paste the hotspot.
ForeHelp retains the link between the hotspot text and its target.

To Change a Jump's Target or Modify Its Properties

Use these instructions for changing the topic or target linked to the jump, changing window classes, or changing the appearance of the jump.

1.	Place the cursor inside the hotspot.

2.	Choose the Text|Edit Jump command, press the [image] [image] keys, or click on the [image] or [image] toolbar button to access the Edit Jump dialog box.  This dialog box shows the current hotspot properties.

3.	Select a new Target, change the Hidden or No Color options, or select a Window class.

4.	Choose the OK button.

To Change a Popup's Target or Modify Its Properties

Use these instructions for changing the topic or target linked to the popup or changing the appearance of the popup.

1.	Place the cursor inside the hotspot.

2.	Choose the Text|Edit Popup command, press the [image] [image] keys, or click the [image] or [image] toolbar button to access the Edit Popup dialog box.  This dialog box shows the current hotspot properties.

3.	Select a new Target or change the Hidden or No Color options.

4.	Choose the OK button.

To Delete a Hotspot

On a graphic

1.	Double-click to edit the .SHG file.

2.	Click on the hotspot you want to delete so that the handles are showing.

3.	Press the [image] key.

Within text, without deleting the text

Use these instructions when you want to retain the text but do not want the text to be linked to another topic.

1.	Click inside the hotspot.

2.	Choose the Text|Edit Popup/Jump command, press [image] [image], or click on the [image] toolbar button to access the Edit Jump or Edit Popup dialog box.  The hotspot's target is selected in the Target list box.

3.	Choose the Remove button.

Within text, deleting the text

Use these instructions to delete the text and its link at the same time.

1.	Select the text and the surrounding corner brackets.

2.	Press the [image] key.

Edit Jump or Edit Popup Dialog Box

Note:  The Edit Popup dialog box has the same fields and buttons as the Edit Jump dialog box with the exception of the Window drop-down list.

Click on the parts of the box below where [image] appears for explanations of features.


Character Format Dialog Box
Character Format or Font Dialog Box

The Character Format dialog box shown here appears whenever you choose Format|Character, press [image] [image], or click on the [image] toolbar button.  A variation of this dialog box appears whenever you choose File|Fonts or click on the  [image] toolbar button within the Navigator, Grapher or Reporter windows.  A variation of this dialog box also appears whenever you choose a Font... button from within a ForeHelp dialog box.  These variations typically offer a smaller range of Effects options.

Click on the parts of the box below where [image] appears for explanations of features.


Clipboard

The Clipboard is a Windows Accessory storage area for text and graphics that have been cut or copied from Windows applications.  The paste option copies the text and graphics from the Clipboard to your document.


Color Dialog Box

The Color dialog box is used for selecting color for text, windows, and banners.  You access this dialog box from within the Character Format dialog box or the Window Classes dialog box.  When the dialog box first appears, it shows only the basic colors.  To display the expanded dialog box shown here, choose the Define Custom Colors button.  To define custom colors, see Creating Custom Colors.

Click on the parts of the box below where [image] appears for explanations of features.


Compile

Compile is the process that uses the .HPJ and the .RTF files from Build to create an .HLP file that WinHelp can open.  Access Compile by choosing the Project|Build command, pressing [image], or clicking on the [image] toolbar button.  See Build and Compile.


Compiler Errors

Warnings and errors can appear in the Project Build Status window during Compile.  Warnings indicate a problem may occur; errors indicate a definite problem.  Compile may or may not be able to create the .HLP file if there are errors.  If the .HLP is created despite an error, the error location in the help file does not work properly.  You can open the HCP.ERR or HC31.ERR file for a description of the error codes.  See your help compiler documentation for more information.

ForeHelp uses HC.PIF to launch the compiler.  We recommend you use a protected mode compiler, such as HCP.EXE, because it can handle larger projects.  Edit the HC.PIF file using Windows' PIF Editor to specify your preferred compiler in the Program File Name text box.

Some common compiler errors are the following:

5059 	Not enough memory to build help file.

1079	Out of File Handles, not enough memory.


Contents

ForeHelp
Table of Contents

What's New in Version 2.0

Introduction

How to Work with...

Project Management Tools

Commands

Reference


Contents Definition
Contents

The Contents topic is the first topic in a help file and usually lists all major topics.  The reader uses the Contents menu button to access the Contents topic in the help file.  You can assign any topic to be the Contents topic in the Project Properties dialog box.


Context Mapping Dialog Box

The Context Mapping dialog box enables you to quickly assign context numbers to context strings and to organize your topics' context strings and numbers into context map files.

A context map file contains the #define commands associated with the context numbers.  During the build process, ForeHelp creates the map files and creates #include commands in the .HPJ file to reference these files, rather than creating #define commands in the .HPJ file.

Choose the Project|Context Mapping command or click on the [image] toolbar button to access the Context Mapping dialog box.

Click on the parts of the box below where [image] appears for explanations of features.


Context Sensitive Help
Context-Sensitive Help

Each topic/target has a context string for internal identification and can also have a context number for identification by external programs, such as context-sensitive help within an application.  Context-sensitive help lets the reader click on a Help button or press [image] while in a dialog box, to display the help topic.  To implement context-sensitive help, the help author and the application programmer need to coordinate the context numbers of the dialog box and the related help topic/target.

ForeHelp automatically enters context strings and their related numbers with #define commands in the .HPJ file.  If you organize context strings and numbers into context map files, ForeHelp enters #include commands in the .HPJ file and creates the map files when you build your project.  For the convenience of your programmers, you can select different formats for the context map files: C, Visual Basic, or Pascal.

You can use the Reporter to print out a list of context strings, numbers and map files for any topics in the project.

There are two options for context number assignment:

The programmer can assign context numbers to each dialog box within the application.  See Programmer Provides Context Numbers.

You (the help author) can assign context numbers to each topic.  See Help Author Provides Context Numbers.  ForeHelp can automatically generate context numbers for all topics and targets in your file.

Once corresponding numbers are in the help file and the program code, build and compile your project  (See Build and Compile.)  The resulting .HLP file must have the same name as application's *.EXE file to enable context-sensitive help.


Context Sensitive Help Definition
Context-Sensitive Help

Context-sensitive help is a system in which the information displayed in the help window is related to an operation being carried out in a program.  For instance, a user might open a program’s dialog box, press [image] or choose the Help button to view a description of that dialog box.  See Context-Sensitive Help.


Context Map File

A context map file contains a table that automatically relates target context strings with context numbers.  When using external programs and macros that require number identifiers, the programmer needs only to use a #include command to open the table rather than defining each string-number connection.  You can create context map files by accessing Project|Context Mapping.  See Context Mapping dialog box or Adding, Changing, Deleting Map Files.


Context Number

A context number is a number used by an external program or macro to identify a target. Context numbers are needed when creating context-sensitive help, for instance.  Every target has a context string, but the context number is optional.  Be careful of changing context numbers if any external programs use them.  See Context-Sensitive Help.


Context String

A context string is a target’s "name," used to identify the target within ForeHelp.  A context string must begin with a letter, number, or underscore.  When you create a new topic, ForeHelp automatically uses the topic title as the context string (replacing special characters and spaces with underscores) to identify the default target at the start of the topic.  See Targets.


Controlling Window Size and Location

The Window Location section of the Window Classes dialog box determines the size and location of the window class when it first opens.  You must specify a size and location for a secondary window.  The reader can resize any WinHelp window after it opens, but the reader cannot change the initial size of a secondary window.

You do not have to set a size or location for the main window.  If you leave the Window Location or Maximized boxes blank, then WinHelp writes the last size and location of the most recently opened help file in the WIN.INI file.  When the reader opens the same or another help file, WinHelp sets the size and location of the window to the current values in the WIN.INI file.

To Control the Size and Location of the Window

You can control the size and location by entering coordinates for the window or by resizing and moving the sample window.

1.	Choose the Project|Window Classes command or click on the [image] toolbar button to access the Window Classes dialog box.

2.	Select the name of the window in the Classes list.
ForeHelp displays the current attribute settings for this window class.

3.	Using the Sample Window:

a)	To resize the window, place the cursor on an edge or corner of the sample window in the Sample box.

b)	When the cursor becomes a double-arrow, drag the edge or corner of the sample window until it is the right size relative to the Sample box.
The percentages in the Height and Width fields of the Window Location section change to match the values represented by the sample window.

c)	To change location of the window, click in the title bar of the sample window.

d)	Drag the window to the desired location.
The percentages in the Origin X and Origin Y fields of the Window Location section change to match the values represented by the sample window.

Or	Using Coordinates:

The coordinates are percentages of the screen size.  The total percentage of the Origin X plus Width fields must be 100 or less.  The total percentage of the Origin Y plus Height fields must be 100 or less.  As you enter numbers in one field that cause the total to exceed 100, ForeHelp automatically decreases the number in the other field.

a)	To resize the window, enter the horizontal size in the Width field of the Window Location section and the vertical size in the Height field.
The sample window reflects the changes to the coordinates.

b)	To change location horizontally, enter a percentage in the Origin X field.  This percentage refers to the location of the left edge of the window relative to the screen.  The value 0 places the left edge of the window at the left edge of the screen.

c)	To change location vertically, enter a percentage in the Origin Y field. This percentage refers to the location of the top edge of the window relative to the screen.  The value 0 places the top of the window at the top of the screen.

4.	To size the WinHelp window to the full-screen size, check the Maximized button.  The sample window does not reflect this option.
If you have also specified a size and location, when the reader minimizes and then restores the window, the window restores to the values in the Window Location fields.

5.	To have a window class always display as the top window regardless of any other windows open on the computer, check the Keep on Top box.

Important:  If you check both Maximized and Keep on Top boxes, the readers must close or minimize this window to see any other windows, including application windows, on their computers.

6.	Change other attributes if needed and choose the OK button when done.


Copy Definition
Copy

You can place a copy of the selected text or graphic(s) on the Clipboard by choosing the Edit|Copy command, pressing [image] [image], or clicking on the [image] toolbar button.


Copying Topics

This topic contains the following sections:

To Copy a Topic

Copy Topic Dialog Box

You can create a new topic by copying the attributes and optionally the text, hotspots, and graphics of the current topic.  The copied attributes include the context map file name, the .RTF file name, and the presence or absence of a banner.

To Copy a Topic

1.	Choose the Topic|Copy Topic command or click on the [image] toolbar button to access the Copy Topic dialog box.

2.	Enter the name of the new topic in the Topic Title field.
The Context String field fills in automatically.

3.	The remaining fields of the dialog box reflect the attributes of the current topic.  You can change these as appropriate for the new topic:

If using context-sensitive help, complete the Context Number and Context Map Files fields.

To place a nonscrolling area at the top of the topic, check Banner.

To place the name you entered in the Topic Title field in the topic's banner or in the first line of topic text if no banner, check Copy Title to Topic.

To add the topic title as a keyword in the master keyword list and to assign the keyword to this topic, check Copy Title to Keyword.

4.	To copy the text, graphics, jumps, popups, and macros from the current topic to the new topic, check the Copy Text box.

5.	Choose the OK button.
The new topic appears in the ForeHelp window.  If you checked the Copy Text box, the new topic looks identical to the previously displayed topic.  However, the status bar displays the new topic title.

See Text Editing for information about entering and editing text in the new topic.

Copy Topic Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Copying and Pasting Pictures

This topic contains the following sections:

To Cut, Copy, and Paste Pictures from within ForeHelp

To Paste a Picture from Other Windows Applications

To Capture and Paste Screens

You can use the Clipboard to paste .WMF or .BMP files that you cut or copied from other Windows applications or from other projects or topics in ForeHelp.  You can also capture screen images and paste them into your ForeHelp project.  ForeHelp tracks each occurrence of the same graphic throughout your database.  If you scale or edit the graphic within ForeHelp, ForeHelp displays a message asking if you want to modify all occurrences of the graphic in this project.

If you paste pictures from other files or from screen captures, ForeHelp uses the following rules.  These rules do not apply to graphics that you cut or copied from the current project.

If the pasted picture is more than 64 Kbytes in size and is a bitmap (.BMP) or metafile (.WMF), ForeHelp creates a file named FH######.BMP or FH######.WMF, where ###### is a randomly generated number for each file.

If the picture is less than 64 Kbytes, is a bitmap or a metafile, and does not contain hotspots, ForeHelp stores the file as part of the topic and does not name it.

If the picture is less than 64 Kbytes and contains hotspots, ForeHelp creates a file named FH######.SHG when you exit the Sheg Editor (###### is a randomly generated number for each file).  You can rename this file if you want.

To Cut, Copy, and Paste Pictures from within ForeHelp

1.	Select the graphic you want to cut or copy by dragging the mouse pointer across it, or place the cursor immediately before it and press [image] [image] until the graphic is highlighted.

2.	Choose the Edit|Cut or Edit|Copy command, press [image] [image] or [image] [image], or click on the [image] or [image] toolbar buttons.

3.	Place the cursor in the topic where you want to paste the picture.

4.	Choose the Edit|Paste command, press [image] [image], or click on the [image] toolbar button.  ForeHelp retains the same name of the graphic file.

To Paste a Picture from Other Windows Applications

1.	Open the Windows application that generated the picture.

2.	Select the picture.

3.	Choose the Edit|Cut or Edit|Copy command to place the picture on the Clipboard.

4.	Open your ForeHelp project.

5.	Place the cursor in the topic where you want to paste the picture.

6.	Choose the Edit|Paste command, press [image] [image], or click on the [image] toolbar button.

To Capture and Paste Screens

1.	Display the window or dialog box you want to capture as a graphic.

2.	Press [image] [image] (Print Screen) to capture the active dialog box or window, or press [image] to capture all images on the entire screen.
Windows places the screen capture onto the Clipboard.

3.	Open your ForeHelp project.

4.	Place the cursor in the topic where you want to paste the picture.

5.	Choose the Edit|Paste command, press [image] [image], or click on the [image] toolbar button.  You can make the image into a segmented hypergraphic file (.SHG) containing hotspots if desired.  See Putting Hotspots on Pictures.


Create Directory Dialog Box

The Create Directory dialog box displays whenever you choose a Create button in a dialog box that lets you select files and directories, such as the Build Directory dialog box.

Click on the parts of the box below where [image] appears for explanations of features.


Creating Borders

This topic contains the following sections:

To Create Border Lines

To Remove Border Lines

You can use borders to frame a graphic, box a quote, put a single line between different sections within a topic, or create lines around cells in a table.  ForeHelp provides thin, thick, and double lines for borders.  You must use the same line style for all borders applied to one paragraph.

To Create Border Lines

1.	Choose the Format|Paragraph command, press [image] [image], or click on the [image] toolbar button to access the Paragraph Format dialog box.

2.	Select the Borders check box to enable borders.  A drop-down list box appears adjacent to the Borders check box.

3.	From the drop-down list box, select the type of line for the border: Thin, Thick, or Double.

4.	Select where you would like the border lines to appear by checking the appropriate boxes: Left, Right, Top, and Bottom.  Select All to create a box around the paragraph.

To Remove Border Lines

1.	Choose the Format|Paragraph command, press [image] [image], or click on the [image] toolbar button to access the Paragraph Format dialog box.

2.	Select the Borders check box to disable borders.  The borders disappear from the selected paragraphs.


Creating Custom Colors

The expanded Color dialog box allows you to create new colors for use with fonts, banners, and backgrounds of the main and secondary windows.

To Create New Colors

1.	Open the Color dialog box either by choosing the Color button on the Character Format dialog box or by choosing one of the Change buttons in the Color section of the Window Classes dialog box.

2.	Choose the Define Custom Colors to expand the Color dialog box.  By default, the Color|Solid box displays the color of the font, banner, or background where the cursor is located.

3.	In the large box, click on the color that you want to start with.  You can also select a color in the Basic Colors section to use as a starting point.
ForeHelp displays the selected color in the Color|Solid box and highlights the color in the large box.  As you modify the color, the new color displays in the Color|Solid box.

4.	You can modify the hue of the color by dragging the highlight to the left or right in the large box or by entering a value in the Hue field.

5.	You can modify the saturation of the color (the intensity of the color) by dragging the highlight up or down in the large box or by entering a value in the Sat field.

6.	You can modify the luminescence of the color, which is the amount of the red, green and blue in the color, by dragging the small triangle up or down the narrow, colored rectangle at the right of the large box.  You can also change the value in the Lum field.  As you change the luminescence, the values in the Red, Green, and Blue fields change accordingly.

7.	To use the color on the Color side of the Color|Solid box, click on Add to Custom Colors.  To use the color on the Solid side of the box, double-click on the color and then click on Add to Custom Colors.
ForeHelp adds colors to the Custom Colors section of the Color dialog box in the following manner:  the first empty box at top left, then bottom left, the next box to the top right, then bottom, and so on.  If you select a box first and then Add to Custom Colors, the filling process begins from that box on in the same order, replacing any existing colors as it goes.

8.	To apply the last defined custom color to your text or to your banner or window background, choose the OK button in the Color dialog box.  Then choose the OK button in the Character Format or Window Classes dialog box.

To apply another custom color, select the color and choose the OK button in the Color dialog box.  Then choose the OK button in the Character Format or Window Classes dialog box.

To define the custom colors without applying a color, choose the OK button in the Color dialog box and then choose the Cancel button in the Character Format or Window Classes dialog box.


Creating Interfile Jumps
Creating and Removing Interfile Jumps

This topic contains the following sections:

To Create a Jump to an Existing Target in Another Help File

To Remove an Interfile Jump

Interfile Jump Dialog Box

You can create jumps to topics that exist in other help project files.  The text appears in the current window unless you select a window class.  You must build and compile your help projects (the project containing the jump and the destination project) before you can test these hotspots.

To Create a Jump to an Existing Target in Another Help File

1.	Select the text that you want to make into a jump.

2.	Choose the Text|Make Jump command, or press [image] [image], or click on the [image] toolbar button to access the Make Jump dialog box.

3.	Check the Interfile box.  ForeHelp displays the Interfile Jump dialog box.

4.	In the Target field, enter the context string of the topic or target in the other help file.

5.	In the File field, enter the name of the compiled help file (.HLP) containing the destination topic.

6.	Complete the other options as appropriate for your project:

To display the jump with a solid underline and in the same color as the surrounding text, check the No Color box.

To display the jump as plain text with no underlines, check the Hidden box.  You typically use hidden jumps on graphics or when all of the text in the window is hot.

To display the target in a different window than the window containing the jump, you must create the secondary window in the destination help file, not in the current help file.  Then, when you create the interfile jump, select the appropriate window class name in the Window list box.  If you select the default <none> or do not select a window class name, WinHelp replaces the topic containing the jump with the target topic in the current window.  NOTE: If you want to jump from a secondary window back to the main window, be sure to select the window class name main.

7.	Choose the OK button.

To Remove an Interfile Jump

1.	Place the text cursor in the interfile jump hotspot.

2.	Choose the Text|Edit Jump command, or press [image] [image], or click on the [image] toolbar button to access the Edit Jump dialog box.

3.	Choose the Remove button.  ForeHelp removes the link, removes the corner brackets from the hotspot text, and closes the Edit Jump dialog box.

interfile Jump Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Creating Interfile Popups
Creating and Removing Interfile Popups

This topic contains the following sections:

To Create a Popup to an Existing Target in Another Help File

To Remove an Interfile Popup

Interfile Popup Dialog Box

To Create a Popup to an Existing Target in Another Help File

1.	Select the text from which you want to move to a popup topic.

2.	Choose the Text|Make Popup command, or press [image] [image], or click on the [image] toolbar button to access the Make Popup dialog box.

3.	Check the Interfile box.  ForeHelp displays the Interfile Popup dialog box.

4.	In the Target field, enter the context string of the topic or target.

5.	In the File field, enter the name of the compiled help file (.HLP) containing the destination topic.

6.	Complete the other options as appropriate for your project:

To display the popup with a dotted underline and in the same color as the surrounding text, check the No Color box.

To display the popup as plain text with no underlines, check the Hidden box.  You typically use hidden popups on graphics or when all of the text in the window is hot.

7.	Choose the OK button.

To Remove an Interfile Popup

1.	Place the text cursor in the interfile popup hotspot.

2.	Choose the Text|Edit Popup command, or press [image] [image], or click on the [image] toolbar button to access the Edit Popup dialog box.

3.	Choose the Remove button.  ForeHelp removes the link, removes the corner brackets from the hotspot text, and closes the Edit Popup dialog box.

Interfile Popup Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Creating Jumps

This topic contains the following sections:

To Create a Jump to an Existing Target

Make Jump Dialog Box

To edit jumps, see Changing or Deleting Jumps and Popups

ForeHelp enables you to create jumps:

On pictures.  See Putting Hotspots on Pictures.

To existing topics and targets in the same project file.  See To Create a Jump to an Existing Target.

To existing topics and targets in other project files.  See Creating Interfile Jumps.

To one or more new topics.  See Creating Topics and Hotspots Simultaneously.

To Create a Jump to an Existing Target

1.	Select the text that you want to make into a jump.

2.	Choose the Text|Make Jump command, or press the [image] [image] keys, or click on the [image] toolbar button to access the Make Jump dialog box.

3.	The Targets box lists the titles of your project's topics with the context strings of targets listed indented beneath their topic's title.  To display an alphabetical list of context strings rather than the titles, check the Show Context Strings Only box.

4.	In the Targets list box, select the destination topic to link to this jump.

5.	Complete the other options as appropriate for your project:

To display the jump with a solid underline and in the same color as surrounding text, check the No Color box.

To display the jump as plain text with no underlines, check the Hidden box.  You typically use hidden jumps on graphics or when all of the text in the window is hot.

To display the target in a different window than the window containing the jump, select the appropriate window class name in the Window drop-down list box.  If you do not select a window class name or select the default <none>, WinHelp replaces the topic containing the jump with the target topic in the current window.  NOTE: To jump from a topic in a secondary window back to the main window, select the window class name main.

6.	Choose the OK button.

Make Jump Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Creating New Styles

This topic contains the following sections:

To Create a New Style

New Style Dialog Box

To Create a New Style

1.	Choose the Format|New Style command or press [image] [image] [image] to access the New Style dialog box.

2.	In the Based On drop-down list box, select a style on which to base the new style.  By default, the style currently in use when you enter the dialog box displays.  If you select the blank option, you start with the current settings, but the new style is not affected by changes in a based-on style.  The Based On style name appears in the description box followed by a plus sign (+).

3.	In the Name field, enter a name for the new style.

4.	Make any Character Format and/or Paragraph Format changes.  The description box lists all the changes that you make.

5.	To assign an accelerator key to this style, select a key number in the Accelerator list box.  If the number is already in use, a message displays and enables you to confirm the use of the selected accelerator key or to cancel it.

6.	Choose the Apply button to apply the style to the paragraph containing the cursor, save the definition, and close the dialog box.  Or choose the OK button to save the new style definition and close the dialog box without applying the style.

New Style Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Creating New Topics

This topic contains the following sections:

To Create a New Topic with the New Command

You can create a new topic using the Topic|New command.  This command enables you to associate attributes with the topic.  These attributes include information for context-sensitive help, the presence or absence of a banner, and the name of the .RTF file where the topic text is placed when you build your help project.

Alternatively, you can create a topic that contains the same attributes as the current topic by using the Topic|Copy Topic command.  This command provides an option for copying the text, graphics, and hotspots to the new topic.  See Copying Topics for instructions.

You can create new topics automatically when you create jumps, popups, or a table of contents.  See Creating Topics and Hotspots Simultaneously or Table of Contents.

To Create a New Topic with the New Command

1.	Choose the Topic|New command, press [image] [image], or click on the [image] toolbar button to access the Topic Properties dialog box.

2.	Enter a topic title.  The Context String field automatically fills with the same information.  These are the only two required fields.

3.	Select other options as appropriate.  If using context-sensitive help, complete the Context Number and Context Map Files fields.  (See Selecting a Context Map File.)

To place a nonscrolling area at the top of the topic, check Banner.

To place the name you entered in the Topic Title field in the topic's banner or in the first line of topic text if no banner, check Copy Title to Topic.

To add the topic title as a keyword in the master keyword list and to assign the keyword to this topic, check Copy Title to Keyword.

4.	Choose the OK button.  The new topic appears on your screen.

See Text Editing for information about entering and editing text in the new topic.


Creating Popups

This topic contains the following sections:

To Create a Popup to an Existing Topic

Make Popup Dialog Box

To edit jumps, see Changing or Deleting Jumps and Popups

ForeHelp enables you to create popups:

On pictures.  See Putting Hotspots on Pictures.

To existing topics or targets in the same project file.  See To Create a Popup to an Existing Topic.

To existing topics or targets in other project files.  See Creating Interfile Popups.

To one or more new topics.  See Creating Topics and Hotspots Simultaneously.

Warnings:  Do not create popups to topics that have banners, because WinHelp displays only the banner.  Do not create popups to long topics or targets, because the reader cannot scroll through a popup window.

To Create a Popup to an Existing Topic

1.	Select the text from which you want to move to a popup topic.

2.	 Choose the Text|Make Popup command, press [image] [image], or click on the [image] toolbar button to access the Make Popup dialog box.

3.	The Targets box lists the titles of your project's topics with the context strings of targets listed indented beneath their topic's title.  To display an alphabetical list of context strings rather than the titles, check the Show Context Strings Only box.

4.	In the Targets list box, select the destination topic to link to this popup.

5.	Complete the other options as appropriate for your project:

To display the popup with a broken underline and in the same color as surrounding text, check the No Color box.

To display the popup as plain text with no underlines, check the Hidden box.  You typically use hidden popups on graphics or when all of the text in the window is hot.

6.	Choose the OK button.

Make Popup Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Creating Rich Text Format (.RTF) Files

This topic contains the following sections:

To Access the .RTF File Options

RTF File Options Dialog Box

When you build a project from your ForeHelp database, ForeHelp places the topic text in a Rich Text Format (.RTF) file.  The WinHelp compiler requires at least one .RTF file as input along with the project file (.HPJ).  You can also insert .RTF files into any ForeHelp database or open them using a word processing package (on Windows or Macintosh) that supports this file type.  The Reporter can display and print a list of all .RTF files used in your project, with or without a list of topics assigned to each file.  It can also display and print the name of the .RTF file for any selected topics.

Note:  If you plan to work with an .RTF file in a word processor, you can create a special .RTF file that does not contain the WinHelp codes.  See Generating Manuals.

ForeHelp enables you to create and assign topics to different .RTF files during the build process and provides four options for creating .RTF files.

To Access the .RTF File Options

1.	Choose the Project|Build command, press [image], or click on the [image] toolbar button to access the Build dialog box.

2.	Choose the RTF Files button to access the RTF File Options dialog box.

3.	Select one of the following options:

Build one RTF file

Build all RTF files

Select RTF files to build

Select topics to build

RTF File Options Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Creating Targets

This topic contains the following sections:

To Create a Target with Selected Text

To Create a Target without Selected Text

Insert Target Dialog Box

To edit a target, see Editing Targets.

You can create targets anywhere within a topic.  Targets located at the beginning of paragraphs display appropriately.  If you place a target within a paragraph, your readers may see unpredictable results.

You can create targets with text selected or unselected.  When you have selected text, ForeHelp creates a target immediately prior to the selected text and uses the selected text as the context string.  One application of this is to create targets to subheadings within a topic.  When you have not selected text, you must enter the context string manually.  ForeHelp creates the target at your cursor location.

To Create a Target with Selected Text

1.	Select the text you want to use as a context string.

2.	Choose the Text|Insert Target command, or click on the [image] toolbar button to access the Insert Target dialog box.

3.	The Context String field contains the selected text.  You can edit this text and complete the other optional fields.

4.	Choose the OK button.
A target symbol [image] displays in your topic when text detail is turned on.

To Create a Target without Selected Text

1.	Place the cursor at the beginning of the appropriate paragraph.

2.	Choose the Text|Insert Target command, or click on the [image] toolbar button to access the Insert Target dialog box.

3.	Enter the name of the target in the Context String field.  Other fields are optional.

4.	Choose the OK button.
A target symbol [image] displays in your topic when text detail is turned on.

Insert Target Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Creating Topics and Hotspots Simultaneously

This topic contains the following sections:

To Create One Topic and One Hotspot

To Create Multiple Topics and Multiple Hotspots

You can create jumps or popups and create the destination topics at the same time.

To Create One Topic and One Hotspot

When you create one jump or popup to a new topic in this same project, the new topic appears in your workspace so that you can enter the new text.

1.	Select the text you want to link to a new topic.

2.	Choose the Text|Make Jump or Make Popup command (or click on the [image] or [image] toolbar button) to access the Make Jump or Make Popup dialog box.

3.	Choose the Hidden or No Color options if desired.  You can also select the Window class for a jump.

4.	Choose the New Topic button.
The Topic Properties dialog box appears with the Topic Title and Context String fields filled with the selected text.

5.	Make any desired changes to the Topic Properties dialog box.  If you are creating a popup, do not check the Banner box.  Popups to topics with banners only display the banner in WinHelp.

6.	Choose the OK button.
The new topic appears on the screen.

7.	Enter text into the new topic or press [image] [image] to return to the previous topic.

To Create Multiple Topics and Multiple Hotspots

When you create several new topics and jumps or popups to them at the same time, the current topic remains in your workspace until you choose to move to a new topic.  This is one method of creating a table of contents or a glossary.  (Another method is to use the Topic|Generate Table of Contents command.)

1.	Select one or more paragraphs of text that represent the new topic titles.  Each paragraph becomes a separate topic.

Warning: If you select multiple new lines within the same paragraph, ForeHelp creates only one topic.

2.	Choose the Text|Make Multiple Jumps or Make Multiple Popups command or click on the [image] or [image] toolbar button.
The current topic remains on the screen with the hotspots displayed.  ForeHelp automatically creates new topics for each hotspot, completing the Topic Properties dialog box with your selected text as the Topic Title and Context String and using the check box values of the launching topic.  If you create multiple popups, ForeHelp creates the new topics without banners.

3.	Use the new hotspots to go to each linked topic to adjust the topic properties if needed and to enter text.  See Using Jumps and Popups.


Creating a New Help Project

To Create a New Help Project

1.	Choose the File|New/Open command, press [image] [image], or click on the [image] toolbar button to access the New/Open/Open As Template dialog box.

2.	In the File Name field, enter the name for the new project.  ForeHelp appends a .DBA extension.

3.	In the Drive and Directory lists, select the drive and directory where you want to place this project.

4.	The Edit Copy box is checked by default for safety.  This enables you to revert to the most recently saved version of your project at any time.

5.	Choose the OK button.
The Project Properties dialog box appears.

6.	In the Project Title field, enter the name that you want displayed in the title bar of your final help file.  This is a required field.  See Project Properties dialog box for an explanation of the other options.

7.	Choose the OK button.  The Topic Properties dialog box appears for the first topic, called  Contents.

8.	To add a nonscrolling region at the top of the Contents topic, check the Banner box.  See Topic Properties dialog box for an explanation of the other options.

9.	Choose the OK button.  Your cursor is in the Contents topic.  You are ready to enter topic text.

10.	To create additional topics, see Creating New Topics.


Creating a Table

This topic contains the following sections:

To Create a Table

Table Size Dialog Box

When you create a table, you specify the number of rows and columns for the table.  As you work with the table, you can add and delete rows and columns as needed.

To Create a Table

1.	Place the cursor in the topic where you want the table.  If you highlight text or place the cursor within a table, you cannot create a new table.

2.	Choose the Text|Insert Table command or the [image] toolbar button to access the Table Size dialog box.

3.	In the Table Size dialog box, enter the number of rows and columns for the table.

4.	Check the Autosize Column Width box if you want WinHelp to enlarge the width of the cells to fill up the full window size.  The column width is never less than the Cell Width setting in the Cell Properties dialog box.  By default, all cells are 2" wide.

Table Size Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Creating and Deleting Window Classes

This topic contains the following sections:

To Create a Secondary Window Class

To Change a Window Class Name

To Delete a Window Class

Window Classes Dialog Box

By default, ForeHelp creates a main window class named main.  You can modify it but not delete it.  You can create up to five secondary windows.  Only one secondary window class can display at a time.

When you create a secondary window, you can specify a caption for its title bar and specify its size, location, background color, and banner color.  At any time, you can modify the attributes of a secondary window or the primary window.  ForeHelp displays a sample window that reflects the attributes you assign.

To Create a Secondary Window Class

1.	Choose the Project|Window Classes command or click on the [image] toolbar button to access the Window Classes dialog box.

2.	Choose the New button.
The Enter New Window Class Name dialog box (a ForeHelp edit/new name dialog box) appears.

3.	In the New Name field, type the name for the new window class.

4.	Choose the OK button.
The Window Classes dialog box is now active and displays the new window class name in the Classes list.  The Window Location box is checked and default coordinates are entered for the window class location and size; and a sample window appears in the Sample box.

5.	Specify the desired attributes of the window.  See Adding Captions to Windows, Controlling Window Size and Location, and Changing Window and Banner Colors.

6.	Choose the OK button.
ForeHelp creates a window class.  When you create a jump hotspot, the name of the window class appears in the Window Class list.

To Change a Window Class Name

1.	Select the window class name in the Classes list box.

2.	Choose the Change button.
The Edit Window Class Name dialog box appears, which is a standard ForeHelp Edit Name dialog box.

3.	Enter a new name in the New Name field.

4.	Choose the OK button.
The Window Class dialog box is again active and shows the new name in the Classes list box.

To Delete a Window Class

1.	Select the window class name in the Classes list box.

2.	Choose the Delete button.

3.	Choose the OK button.
ForeHelp deletes the window class.

Window Classes Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Creating and Modifying a Sequence Name

This topic contains the following sections:

To Create a Browse Sequence Name

To Change a Browse Sequence Name

To Delete a Browse Sequence Name

Sequences Dialog Box

If you create more than one browse sequence in a project, you must provide a name for each sequence.  If your project contains only one browse sequence, you do not need to name it.  ForeHelp uses the default sequence name, [unnamed].

To Create a Browse Sequence Name

1.	Choose the Project|Browse Sequences command, or press [image] [image] [image], or click on the [image] toolbar button to access the Project Browse Sequences dialog box.

2.	Choose the Sequences button or press [image] [image] to access the Sequences dialog box.

3.	In the Sequences text box, type the name of the new sequence, up to 31 characters.  Alternatively, you can choose the New button to access the Enter New Browse Sequence Name dialog box (a ForeHelp edit/new name dialog box).  In the New Name field, type the name of the new sequence and choose the OK button to return to the Sequences dialog box.

4.	Choose the Done button.  The Sequences dialog box closes and the Project Browse Sequences dialog box becomes active.  The new name appears in the Sequence drop-down list.

5.	To create the browse sequence, see Assigning and Viewing Topics in a Browse Sequence.

To Change a Browse Sequence Name

1.	Choose the Project|Browse Sequences command, or press [image] [image] [image], or click on the [image] toolbar button to access the Project Browse Sequences dialog box.

2.	Choose the Sequences button or press [image] [image] to access the Sequences dialog box.

3.	In the Sequences list box, select the name of the sequence that you want to change.

4.	Choose the Change button.  The Edit Browse Sequence Name dialog box appears, which is a standard ForeHelp edit name dialog box.

5.	In the New Name field, edit the name.

6.	Choose the OK button.  The Sequences dialog box is again active and displays the changed name.

7.	Choose the Done button.  The Sequences dialog box closes and the Project Browse Sequences dialog box becomes active.  The changed name appears in the Sequence drop-down list.

To Delete a Browse Sequence Name

When you delete the name of a browse sequence that has topics assigned to it, you delete the entire browse sequence.

1.	Choose the Project|Browse Sequences command, or press [image] [image] [image], or click on the [image] toolbar button to access the Project Browse Sequences dialog box.

2.	Choose the Sequences button or press [image] [image] to access the Sequences dialog box.

3.	In the Sequences list box, select the name of the sequence that you want to delete.

4.	Choose the Delete button.  ForeHelp deletes the name from the Sequences list.

5.	Choose the Done button.  The Sequences dialog box closes and the Project Browse Sequences dialog box becomes active.

Sequences Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Creating/Editing/Deleting Embedded Windows

This topic contains the following sections:

To Create an Embedded Window

To Edit an Embedded Window

To Delete an Embedded Window

Edit Embedding Dialog Box

To Create an Embedded Window

1.	Position the cursor in the current topic where you want to place the window.

2.	Choose Text|Insert Embedding to access the Choose Embedded Window DLL dialog box, which is a standard Windows file open dialog box.

3.	Select the name and location of the DLL.

4.	Choose the OK button.  If the selected DLL is ForeHelp compatible, the DLL may display a dialog box asking you for more information.  See the documentation provided by the DLL supplier.

If the DLL is not ForeHelp compatible or if it does not require additional information, the Edit Embedding dialog box appears with the name of the selected DLL in the DLL Name field.

5.	Enter the required window class and any parameters needed by the DLL (such as a file name) in the Class Name and Data fields.  The supplier of the DLL should provide this information to you.

6.	Choose the OK button.  ForeHelp displays a ForeHelp-compatible DLL in the ForeHelp window at your cursor location.  If the DLL is not ForeHelp compatible, ForeHelp displays a box containing the DLL name and its parameters.  To view a non-compatible DLL, choose the Project|Test command or build and run your help file.

To Edit an Embedded Window

1.	In the ForeHelp window, click on the embedded window to select it.

2.	Choose the Text|Edit Embedding command to access the Edit Embedding dialog box.

3.	Make any desired changes.

4.	Select the OK button.

To Delete an Embedded Window

1.	In the ForeHelp window, click on the embedded window to select it.

2.	Press the [image] key.

Edit Embedding Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Cursor Movement Keys
Cursor Movement/Selection Keys

The following keystrokes allow you to move the cursor quickly through your text.  Use [image] in combination with cursor movement keys to select or highlight text.

One character to the right

One character to the left

One line up

One line down

One word to the right

One word to the left

One paragraph up

One paragraph down

Beginning of the line

End of the line

Beginning of the topic’s first line

End of the topic’s last line

Up one screen

Down one screen


Customize Toolbar Dialog Box

To access the Customize Toolbar dialog box, choose the File|Toolbar command.  For instructions on adding and removing buttons, see Using the Toolbar.  For a description of each toolbar button, see Toolbar Buttons.

Click on the parts of the box below where [image] appears for explanations of features.


Cut Definition
Cut

To remove the selected text or graphic(s) from your text and place it on the Clipboard, choose the Edit|Cut command, press [image] [image], or click on the [image] toolbar button.   Use Paste to insert the text in another location.


Cut, Copy and Paste
Cut, Copy, and Paste

Like most Microsoft Windows applications, ForeHelp can use the Windows Clipboard to cut (move), copy, and paste (insert) text and graphics from one place to another (within a topic, between topics, or between Windows applications).

To Cut, Copy, and Paste

1.	Select the contiguous text/graphic(s) you want to move or copy.  See Selecting Text.

2.	To Cut (move) the text, choose the Edit|Cut command, press [image] [image], or click on the [image] toolbar button.  ForeHelp deletes the text from its original location and places it on the Clipboard.

or

To Copy the text, choose the Edit|Copy command, press [image] [image], or click on the [image] toolbar button.  ForeHelp places a copy of the text on the Clipboard and leaves the original text in place.

3.	Move your cursor to the place where you want to insert the selected text or graphics.

4.	To insert the text or graphic(s), choose the Edit|Paste command, press [image] [image], or click on the [image] toolbar button.

The cut or copied information remains in the Clipboard until you overwrite it by cutting or copying something else or until you close Windows.  You can paste the same information multiple times.


DLL
.DLL

.DLL is the file name extension used by a Dynamic Link Library (DLL) file, a file containing program code that can be used by various Windows programs.  DLLs can contain macros, program icons, multimedia programs, or any other form of data.  You can insert DLLs into ForeHelp projects.  See Embedded Windows.


Deleting Keywords

This topic contains the following sections:

To Delete a Keyword from the Master Keyword List

To Remove a Topic Keyword

To Remove a Text Keyword

To Delete a Keyword from the Master Keyword List

1.	Choose the Topic|Keywords command, press [image] [image], or click on the [image] toolbar button to access the Topic Keywords dialog box.

2.	Choose the Edit button or press [image] [image] to access the Edit Master Keyword List.

3.	In the Keywords box, select the keyword you want to delete.

4.	If no topics display in the Topics box for the selected keyword, choose the Delete button.  ForeHelp deletes the keyword from the master list.

If the Topics box contains topic titles, you must first remove the keyword from any topics before deleting it from the master keyword list.

5.	Choose the Done button.  The Topic Keywords dialog box reappears.

6.	Choose the OK button.

Warning: Selecting the Cancel button in the Topic Keywords dialog box deletes all the changes you just made to the master keyword list.

To Remove a Topic Keyword

1.	Choose the Topic|Keywords command, press [image] [image], or click on the [image] toolbar button to access the Topic Keywords dialog box.

2.	In the Topic drop-down list box, select the topic that contains the keyword you want to remove.

3.	In the Keywords list box, select the keyword and choose the Remove button, or double-click the keyword.  If the keyword appears only in this one topic, a message displays asking if you want to remove the keyword from the master keyword list as well.

4.	Choose the OK button to save all changes made while in the Topic Keywords dialog box.

To Remove a Text Keyword

1.	Select the key marker:

a.	With text detail turned on, locate the key marker ( [image]) indicating the keyword location.

b.	Place the cursor next to the key marker.

c.	Use the left or right arrow key to move the cursor onto the key marker.
When the cursor is on the key, the right field of the status line displays 'Keyword: keyword text'.

d.	If you have several text keywords assigned at the same location, keep pressing the [image] or [image] key until the status line displays the keyword that you want to remove.

2.	Press the [image] key.  Or choose the Text|Edit Text Keyword command or [image] [image] to access the Keyword in Text dialog box and choose the Remove button.  ForeHelp deletes the keyword from this text location but not from the master keyword list.  If you have assigned several keywords to the same location, the key marker remains visible.


Deleting Styles

To Delete a Style

1.	Choose the Format|Delete Style command or press [image] [image] [image] to access the Delete Style dialog box.

2.	Select the style you want to delete in the Name list box.
A highlight appears at the left edge of the window next to the paragraphs in the current topic that have this style applied.

Be careful when deleting styles that were used as the based on style for other styles.  The other styles remain, but the applicable attributes revert to the Base style.

3.	Choose the OK button.

Click on the parts of the box below where [image] appears for explanations of features.


Deleting Targets

This topic contains the following sections:

To Delete a Target

When you delete a target, ForeHelp deletes its context string from all lists of targets.  If the target is connected to a hotspot when you delete it, the hotspot becomes unresolved, which means that ForeHelp cannot find the destination target for the hotspot.  If you build the project with unresolved hotspots, ForeHelp provides error messages for each unresolved hotspot.  ForeHelp allows you to easily reconnect the unresolved hotspots to new topics or targets because it stores the context strings of connected targets that you deleted.  You can reuse these context strings with other topics or targets.  If the target was not connected when you deleted it, ForeHelp does not store its context string.  To reconnect an unresolved hotspot to a new target, see Reconnecting Targets.

To Delete a Target

1.	Position the cursor on the target you want to delete:

a.	With text detail turned on, locate the arrow indicating the target location [ [image]].

b.	Place the cursor at the start of the paragraph, then use the left arrow key to move the cursor onto the target arrow.
When the cursor is on the target, the right field of the status line displays 'Target: context string'.

2.	Press the delete key [image].
Or choose the Text|Edit Target command, press [image] [image], or click on the [image] toolbar button to access the Edit Target dialog box.  Choose the Remove button.

ForeHelp deletes the target from the project, unless there are still hotspots linked to this target.  In this case, ForeHelp adds the target to the disconnected targets list.


Deleting Topics

This topic contains the following sections:

To Delete a Topic

To Reconnect Unresolved Hotspots to a New Topic

Be careful of deleting a topic that contains targets used by jumps or popups from other files.  You will receive warnings of unresolved jumps or popups during build.  The reader receives an error message indicating that the help file does not exist when attempting to use the hotspot leading to the nonexistent topic in the final help file.  You can review the topic's relationships in the Navigator prior to deleting it to see what is affected.

If you delete a topic that contains targets connected to hotspots, ForeHelp lets you easily reconnect the hotspots to a new topic because it stores the context strings of the deleted targets and topics.  To reconnect a hotspot to a target within a topic, see Reconnecting Targets.

To Delete a Topic

Note: You cannot delete the topic that is defined as the Conents topic.

1.	Go to the topic to be deleted (See Moving Among Topics).

2.	Choose Topic|Delete, press [image] [image], or click on the [image] toolbar button.  ForeHelp displays a message asking you to confirm that you want to delete this topic.

3.	Press Y or [image] for Yes.  ForeHelp deletes the topic from the database.

To Reconnect Unresolved Hotspots to a New Topic

1.	Create a new topic.  See Creating Topics.

2.	In the Topic Properties dialog box, click on the down arrow on the Context String field.  ForeHelp displays a list of the disconnected context strings from previously deleted targets.

3.	Select the context string that is connected to the appropriate hotspots.

4.	Choose the OK button.  ForeHelp reconnects all the hotspots that were connected to this context string to the new topic.


Deleting a Table

To Delete a Table

1.	Select the entire table including the paragraph marker preceding the table.

2.	Press the [image] key


Disconnected Targets

A disconnected target is a context string of a target that has been deleted but still has jumps or popups associated with it.  See Reconnecting Targets for information about connecting the jumps and popups to a new target or another target.


Edit Alias Dialog Box

The Edit Alias dialog box appears when you enter a new alias name in the All Aliases text box in the Project Aliases dialog box and select the Add button.  It also appears when you select an alias name from the All Aliases list box and select the Edit button.  This dialog box enables you to add or change the name (context string), context number, or context map file for the selected alias.

To assign context numbers or map files for multiple aliases, select Project|Context Mapping to access the Context Mapping dialog box.

Click on the parts of the box below where [image] appears for explanations of features.


Edit Menu

Command	Keyboard	Toolbar	Description
Undo/Redo			Undoes the last editing operation.  Option changes to Redo, which reapplies the original action.
Cut			Removes the selected text or graphics and places it on the Clipboard.  The Clipboard contents can be pasted elsewhere.
Copy			Copies the selected text or graphics to the Clipboard for pasting elsewhere.
Paste			Copies the contents of the Clipboard to the cursor location.
Paste Special			Copies .RTF text from the Clipboard to the cursor location with options for breaking into topics and for retaining or overriding styles within the pasted text.  Accesses the Paste Special dialog box.
Delete			Deletes the selected text or graphics.
Delete a Row or Column			Deletes the selected table row(s) or column(s) when the cursor is in a table.
Select All			Selects all the text and graphics at the cursor location, in the topic text or in the banner.
Select Row			Selects the table row in which the cursor is placed.
Select Column			Selects the table column in which the cursor is placed.
Select Table			Selects all cells in the table in which the cursor is placed for table formatting or modification.


Edit Picture Placement Dialog Box

If you edit a picture smaller than 64K in size, the Picture Placement dialog box appears.  You can select one of the following options.  See Working with Pictures in Text for information and examples.

Character	The graphic is placed on the current line as if it were a character.  Depending on the picture's height, extra space is allocated above the line for the image (providing Line Spacing in the Paragraph Format dialog box is not set to Exactly).

Left	The left edge of the graphic is placed at the From Left indent setting in the Paragraph Format dialog box (the left margin icon on the ruler).  Continuous text wraps around the right edge of the picture.  Pressing [image] causes the next paragraph to begin below the graphic.  Press [image] [image] to make the text continue to wrap alongside.

Right	The right edge of the graphic is placed at the From Right indent setting in the Paragraph Format dialog box (the right margin icon on the ruler.)  Continuous text wraps around the left edge of the picture.  Pressing [image] causes the next paragraph to begin below the graphic.  Press [image] [image] to make the text continue to wrap alongside.

Click on the parts of the box below where [image] appears for explanations of features.


Editing Macros

This topic contains the following sections:

To Edit a Macro

To Change the Order of a Macro

Before you can edit a macro in your project, topic, or hotspot, you must access the appropriate macro dialog box (See Accessing Macro Dialog Boxes).

To Edit a Macro

1.	In the Current Macro Commands list of the macro dialog box, select the macro you want to edit.

2.	Choose the Edit button.
The selected command appears in the Command List field and its first parameter appears in the Parameters section.

3.	If the first parameter is correct, use the Next button to display the next parameter or the parameter that you want to change.

4.	Enter a new parameter value or select a value from the drop-down parameter list (if available).

5.	Choose the Insert button.
The changes appear in the Command List field.

6.	Choose the Replace button to remove the selected macro in the Current Macro Commands list and to add the modified macro

Note: If you choose the Add button, ForeHelp retains the original macro and adds the modified macro.

7.	Choose the OK button.

To Change the Order of a Macro

1.	Click on the macro you want to move.

2.	Choose Up or Down as appropriate.


Editing Styles

This topic contains the following sections:

To Change a Style's Attributes

Edit Style Dialog Box

Be careful when changing a style on which other styles are based.  Changes to such a style reflects in the styles which were created using it as a base.  (When you select a style name, all text with that style are highlighted along the left side of the screen identifying the affected text.)

To Change a Style's Attributes

1.	Choose the Format|Edit Style command or click on the [image] toolbar button to access the Edit Style dialog box.

2.	Select the style you want to change from the Name drop-down list box.

3.	Make any Name, Based On, Accelerator, Character, and/or Paragraph format changes desired:

To change the name of the style, enter a new name up to 24 characters, excluding \ { } and ;.

To change the based on style, select another style name from the Based On drop-down list box.

To remove the based on style, select the blank option at the top of the Based On list.

To change or add an accelerator key, select a new number from the Accelerator drop-down list box.

To remove an accelerator key, select the blank option at the top of the Accelerator list.

To change the character formats, choose the Character button to access the Character Format dialog box.

To change the paragraph formats, choose the Paragraph button to access the Paragraph Format dialog box.

The new characteristics display in the text box.

4.	Choose the OK button.

Edit Style Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Editing Targets

This topic contains the following sections:

To Move a Target

To Modify a Target's Properties

Edit Target Dialog Box

To Move a Target

1.	Position the cursor on the target you want to move:

a.	With text detail turned on, locate the arrow indicating the target location [ [image]].

b.	Place the cursor at the start of the paragraph, then use the left arrow key to move the cursor onto the target arrow.  When the cursor is on the target, the right field of the status line displays 'Target: context string'.

2.	Press [image] [image] to select the target.

3.	Choose the Edit|Cut command, press [image] [image], or click on the [image] toolbar button.

4.	Place the cursor on the new target location.

5.	Choose the Edit|Paste command, press [image] [image], or click on the [image] toolbar button.

To Modify a Target's Properties

When you change a target's context string, ForeHelp automatically updates all hotspots that reference the target with the new context string.

Important	Use caution when changing the context number and/or context map file if any external programs use these items for context-sensitive help.  Also use caution when changing the context string when another help file has interfile jumps or popups to this target.  If you change these items without also changing the information in the external programs or help file, the program cannot locate the appropriate target.  When your reader attempts to use a hotspot that leads to the target's old context number, an error message displays indicating that the help file does not exist.

1.	Position the cursor on the target you want to modify:

a.	With text detail turned on, locate the arrow indicating the target location [ [image]].

b.	Place the cursor at the start of the paragraph, then use the left arrow key to move the cursor onto the target arrow.  When the cursor is on the target, the right field of the status line displays 'Target: context string'.

2.	Choose the Text|Edit command or click on the [image] toolbar button to access the Edit Target dialog box.

3.	Make any desired changes.

4.	Choose the OK button.

Click on the parts of the box below where [image] appears for explanations of features.


Embedded Window

Embedded windows incorporate external programs that are designed to be used within Windows applications into your ForeHelp project.  You can link the application to a topic, so that when the reader opens the topic a window within a window displays.  See Embedded Windows.


Embedded Windows

This topic contains the following sections:

ForeHelp-Compatible DLLs

Color Palettes

To Include External Files Required by the DLL

You can integrate other Windows programs into your help file through the use of Dynamic Link Libraries (DLLs)--libraries of functions that a Windows module can call to accomplish a task.  The Windows application runs in its own window within your topic.  DLL files can be provided by your programming staff or a third-party supplier.  You must obtain information about the DLL and how it is used from your supplier.

If you use a DLL in your help file, you must distribute the DLL with your .HLP file.

ForeHelp-Compatible DLLs

A ForeHelp-compatible DLL passes information to ForeHelp when you insert the DLL as an embedded window.  This information may contain the class name and the parameters so that you do not need to enter this information.  With this information, ForeHelp can safely display the DLL while in edit mode.  ForeHelp-compatible DLLs may also create dialog boxes that prompt you for additional information.

If the DLL is not compatible with ForeHelp, only WinHelp and ForeHelp's Test mode can display the embedded windows, and the ForeHelp window in edit mode displays the embedded window as a small, outlined box containing the DLL name and its parameters.  This prevents any problems within the DLL from corrupting your ForeHelp database.

To make a DLL compatible with ForeHelp, see ForeHelp User's Manual.

Color Palettes

If an embedded window DLL uses the Windows color palette, WinHelp queries the DLL for its preferred palette when its windows are created.  When a topic contains more than one DLL that requires the palette, the first DLL’s palette is used and the first embedded window displays the correct colors.  The other embedded windows in the topic are drawn in the best way possible with the same palette.  If the embedded windows use a similar palette, the results are fine.  If there is very little color similarity between the two palettes, the results may not be acceptable.

To Include External Files Required by the DLL

If the DLL requires the presence of an external file, you can add the file to the baggage files in your help project.  ForeHelp then includes the file in the compiled help file.  If you do not add the file as baggage, you must ensure that you distribute the required file in the same directory as your help file.

For instructions, see Baggage.


Entering Text

ForeHelp provides a word processor that uses common commands, such as the following:

Starts a new paragraph ( [image]).

Starts a new line as part of the current paragraph ( [image]).

Moves the cursor to the next tab setting ( [image]).

Deletes the character to the left of the cursor.

Deletes the character to the right of the cursor.

The Edit|Undo command, or [image] [image], or the [image] toolbar button undoes the last text and paragraph formatting procedure performed, as long as you remain in the same topic.  The Undo then becomes Redo if you choose to reapply the action.

If you move the cursor within existing text and begin typing, ForeHelp is automatically in insert mode and inserts new text at the cursor.  Existing text moves aside to make room.  The [image] on the keyboard is not used.


Entering Text in a Table

This topic contains the following sections:

To Enter Text in a Table

To Move between Cells

To Create a New Row at the End of the Table

To Move to Tab Settings

To Enter Text in a Table

1.	Place the text cursor in a cell.

2.	Type or paste in the text.  The cell height adjusts automatically as text wraps within the cell.

3.	If you need multiple paragraphs within the same cell, press the [image] key.  If you are using borders in the cell, use multiple new lines ( [image] [image]) rather than multiple paragraphs.

4.	You can format the text within each cell.  See Formatting Tables.

To Move between Cells

Press the [image] key to move to the next cell.

Press the [image] [image] keys to move to the previous cell.

To Create a New Row at the End of the Table

1.	Place the text cursor in the last cell of the last row.

2.	Press the [image] key.  ForeHelp adds a new last row.

To Move to Tab Settings

Press the [image] [image] keys to place the cursor at the next tab setting.  The tab setting can be in the current or subsequent cells.


Entering a Banner

If you checked the Banner box in the Topic Properties dialog box, a horizontal line appears across the window, separating the banner area (nonscrolling region) from the text area.  Text in the banner acts as a topic title and remains at the top of the screen when the reader scrolls through the topic text.

To enter text in the banner, click in the banner or press [image], and begin typing.

To move out of the banner, press the [image] or click in the text area.

When you format the banner area using the Character Format dialog box or Styles, the height of the banner adjusts in size to accommodate the text.

If you are creating a topic that is describing a picture, you can place the picture in the banner to ensure that it is visible while the reader scrolls through the text.


Exporting Context Map Files

If you organize your context numbers into one or more map files, ForeHelp creates these files when you build your project.  ForeHelp can create files in a C, Pascal, or Visual Basic format.  If you select Pascal or Visual Basic as the format, ForeHelp creates this file for your programmers to use and also places the #define statements in the .HPJ file so that the WinHelp compiler can accept it.

To Export Context Map Files

1.	Choose the Project|Build command, press [image], or click on the [image] toolbar button to access the Build dialog box.

2.	In the File Formats section, select C Style, Visual Basic, or Pascal.
The Default Extension field displays the appropriate extension for the selected format.  You can change this extension if needed.

3.	Complete the rest of the dialog box as needed to build your project.  See Build and Compile for instructions.


FHXXXXXX.DBA

FHXXXXXX.DBA is the name of a temporary series of database files that ForeHelp optionally creates while you modify your help project files.  You control the use of temporary files by checking the Edit copy box in the New/Open/Open As Template dialog box.  When you close your project file gracefully, ForeHelp updates your named project files with your changes and deletes the temporary files.  If your project file was not closed properly, ForeHelp retains the temporary files with your recent changes.  For information about using the temporary database, see Opening a Damaged Help Project.


FOREHELP.INI

The FOREHELP.INI file is located in the Windows directory.  It contains ForeHelp initialization settings that display features you have specified through certain dialog box selections.  You can edit FOREHELP.INI by double-clicking on it while in Windows File Manager.


Features for Inserting Rich Text Format Files

This topic contains the following sections:

Options

Handling .RTF Styles

Help authoring products and some word processors for Windows and Macintosh computers can export Rich Text Format (.RTF) files.  These files retain original formatting (character and paragraph formats, styles, tables, and graphics) when inserted or opened in another software product, such as ForeHelp.  ForeHelp quickly and easily converts an .RTF file into a help project, while allowing you to have full control of the conversion options.

Options

When you insert an .RTF file into your ForeHelp project, you can select any of the following options:

Place the entire file into the current topic (up to the 55 Kbytes of data)

Break the .RTF file into separate topics, creating new topics at hard page breaks or at a specified style

Recreate the topics, jumps, popups, and macros and retain the embedded windows and graphics when you insert a file created by a help authoring product

Replace the topics in your current ForeHelp project with the inserted topics

Map bullets from the .RTF to ForeHelp provided bullets

Convert index entries from a hardcopy manual .RTF file to help keywords

Map styles from the .RTF file to your ForeHelp project's styles

Have ForeHelp automatically handle the mapping of styles with the same name

Have ForeHelp automatically create new topics based on a paragraph style and add them to the table of contents and/or add a banner to the new topic.

Associate the inserted topics with the original name of the .RTF file or select another .RTF file for this association.

Handling .RTF Styles

You can also decide how you want ForeHelp to handle inserted text that uses the same style name as your ForeHelp database.  The choices are:

Apply the style definitions from the ForeHelp project to the imported text (override the definitions in the imported text)

Apply the style definitions from the imported text to your ForeHelp project (override the existing definitions in the project)

Retain both style definitions.  ForeHelp appends a number to the imported style name (for example, Base-1).

In all cases, ForeHelp retains all unique style names whether they appear in the imported file or in the ForeHelp project.  You can map unique style names in the .RTF file to other style names in your ForeHelp project.  ForeHelp converts the mapped styles automatically.  For example, your .RTF file might contain the styles Heading 1, Heading 2, and Normal.  You could map both Heading 1 and Heading 2 to Banner Base, and Normal to Base.

When you map unique style names to other style names, ForeHelp updates the FOREHELP.INI file with this information.  Whenever you insert another .RTF file in any ForeHelp project, your last style mappings are shown as the default.


File Menu

Command	Keyboard	Toolbar	Description
New/Open...			Opens an existing database (.DBA), project (.HPJ) or backup (.FHB) file.  Opens an existing database as a template.  Creates a new project, using the New/Open/Open As Template dialog box.
Save Project			Saves all changes made to the copy of your database files to the hard disk.  When you close a project, ForeHelp automatically saves the latest changes.
Revert Project			Removes any changes and restores the project to its state when you last saved it during an edit session. This command is not available if you open a project with the Edit Copy check box cleared.
Backup...			Saves your project including all associated graphics and baggage files in an archive file.  Opens the Backup Project dialog box.
Close			Saves and closes the current help project while leaving ForeHelp open.
Preferences...			Sets hotspot colors, Grapher options, Build preferences, and ForeHelp window attributes using the Preferences dialog box.
Toolbar...			Adds or removes buttons from the toolbar using the Customize Toolbar dialog box.
Print Topics...			Prints a single, several, or all topics using print options you set in the Print Topics dialog box.
Printer Setup...			Changes the default printer to which you print ForeHelp topics via the Print Setup dialog box.
Exit			Closes ForeHelp.  If a database is open when you choose Exit, ForeHelp saves the changes to the database and closes it.


Find

Find lets you search and replace text, convert text to a hotspot, or associate a macro or keyword with the topic containing the text.  Access Find by choosing the Tools|Find command, pressing [image] [image], or clicking the [image] toolbar button.


Find Operations

The Find command can perform one of several operations when it locates the text you entered in the Search For field.  You select an operation from the If Found drop-down list box in the Find dialog box.  To access and use the Find dialog box, see Using Find and Replace.

For instructions on using the different operations, click on the following topics:

Finding and Selecting Text

Finding Text and Replacing with New Text

Finding Text and Making a Jump

Finding Text and Making a Popup

Finding Text and Making a Macro

Finding Text and Adding a Topic Macro

Finding Text and Adding a Keyword


Find and Replace

The Find command on the Tools menu enables you to search for text in your database and to move to the topic containing the text, to replace the text, or to make it into a keyword or hotspot.  When you enter a text string, ForeHelp can search for and select each occurrence of the string in the current topic, in all topics, or in the browse sequence if the current topic is part of a browse sequence.  You can request that ForeHelp search for and select or replace text within topic text, within keywords and titles, and/or within macro arguments.

ForeHelp can also search for a text string within topic text and perform one of the following operations on the text:

Make the selected string into a jump hotspot.

Make the selected string into a popup hotspot.

Make the selected string into a macro hotspot.

Create a topic macro for the topic in which the string is found.

Create a keyword reference for the topic in which the string is found.


Finding Text and Adding a Keyword

To Add a Keyword to the Topic Containing the Text String

You can add a search keyword to the master keyword list and to the topic that contains the searched for text string.

1.	When completing the Find dialog box, select Add Keyword from the If Found drop-down list.

2.	Choose the OK button.
The Add Keyword dialog box appears:

3.	In the Keyword field, enter the name of the keyword to be associated with the text string or select a keyword from the Keyword drop-down list.

4.	Choose the OK button.
If you entered a new keyword, ForeHelp displays a message asking if you want to define a new keyword.  If you choose Yes, ForeHelp adds the keyword to the master keyword list.  If you choose No, select or enter another keyword in the Add Keyword dialog box.

ForeHelp locates the first occurrence of the Search For string and displays the Text Find dialog box.  If you select a Yes option in this dialog box, ForeHelp adds the keyword to the topic containing the string.


Finding Text and Adding a Topic Macro

To Add a Topic Macro

A topic macro command runs whenever the reader accesses the topic containing the macro.  You can use Find to locate a text string and add the same macro command to each topic containing this string.

1.	When completing the Find dialog box, select Add Topic Macro from the If Found drop-down list.

2.	Choose the OK button.
The Macro Editor dialog box appears.

3.	Complete the Macro Editor dialog box as described in Adding Macros
ForeHelp locates the first occurrence of the Search For string and displays the Text Find dialog box.  If you select a Yes option in this dialog box, ForeHelp adds a macro command to the topic containing the string.


Finding Text and Making a Jump

To Make the Text String a Jump Hotspot

1.	When completing the Find dialog box, select Make Jump from the If Found drop-down list.

2.	Choose the OK button.
The Make Jump dialog box appears.

3.	Complete the Make Jump dialog box as described in Creating Jumps.
ForeHelp locates the first occurrence of the Search For string and displays the Text Find dialog box.  If you select a Yes option in this dialog box, ForeHelp makes a jump from the selected text to the specified destination target.


Finding Text and Making a Macro

To Make the Text String a Macro Hotspot

A macro hotspot runs a macro command when the reader clicks on the hotspot.

1.	When completing the Find dialog box, select Make Macro from the If Found drop-down list.

2.	Choose the OK button.
The Macro Editor dialog box appears.

3.	Complete the Make Macro dialog box as described in Adding Macros
ForeHelp locates the first occurrence of the Search For string and displays the Text Find dialog box.  If you select a Yes option in this dialog box, ForeHelp converts the selected text to a macro hotspot.


Finding Text and Making a Popup

To Make the Text String a Popup Hotspot

1.	When completing the Find dialog box, select Make Popup from the If Found drop-down list.

2.	Choose the OK button.
The Make Popup dialog box appears.

3.	Complete the Make Popup dialog box as described in Creating Popups
ForeHelp locates the first occurrence of the Search For string and displays the Text Find dialog box.  If you select a Yes option in this dialog box, ForeHelp makes a popup from the selected text to the specified destination target.


Finding Text and Replacing with New Text

ForeHelp highlights the text string in each topic and replaces the found text with your designated replacement text.  ForeHelp can search for and replace text in topic text, keywords and titles, and/or macro arguments.

1.	When completing the Find dialog box, select Replace Text from the If Found drop-down list.

2.	Choose the OK button.
The Replace Text dialog box appears:

3.	In the Replace With field, enter the new text string as you want it to appear in your project.

4.	If you want the new text to match the case of the original text in your topic, macro, title or keyword, check the Preserve Case box.

5.	Choose the OK button.
ForeHelp locates the first occurrence of the Search For string and displays the Text Find dialog box.  If you select a Yes option in this dialog box, ForeHelp replaces the found text with the text in the Replace With field.


Finding and Selecting Text

ForeHelp displays the first topic in which it finds the text string and highlights the first occurrence of the string.  ForeHelp can search for text in topic text, keywords and titles, and/or macro arguments.

1.	When completing the Find dialog box, select Select from the If Found drop-down list.

2.	To find another occurrence of the same string, choose the Tools|Find Again command, or press [image] [image].


First-Line Indent

The first-line indent defines where the first line of a paragraph starts relative to the paragraph's left margin.  It also defines where new lines of a paragraph start.  (You create new lines using the Text|Line Break command or the [image] [image] keys.)


ForeFront Technical Support

To contact ForeFront Technical Support, refer to the Technical Support section in the ForeHelp User's Guide.


ForeHelp

ForeHelp is a comprehensive help authoring tool developed by ForeFront, Inc.


ForeHelp Concepts & Terms
ForeHelp Concepts and Terms

ForeHelp creates Windows .HLP files--document files that are used by Windows’ own help system, WinHelp.  WinHelp displays your finished product in the WinHelp window (also called the Help window).  You build your help project using the ForeHelp window.

The basic unit in a help project is the topic--a collection of related information.  The topic is similar to a section within a book.  It can contain text as well as pictures--.WMF, .BMP, or .SHG format graphics.  ForeHelp displays one topic at a time in the ForeHelp window.

The Contents topic is the first topic in your project.  It usually contains a listing of all your major topics, similar to a Table of Contents in a book.  Typical Windows applications include a Contents command on the Help menu that provides access to the Contents topic.

You can associate keywords with each topic--the equivalent of the book’s index entries.  Help's Search feature enables the reader to go straight to the needed information by locating topics containing keywords.

Each topic contains at least one target, which is automatically created at the beginning of the text.  You can place additional targets anywhere within a topic to more accurately place the reader when they use hotspots to bring up the target information.

There are several different types of hotspots.  When your reader uses a jump, the new topic is displayed in the help window.  When your reader uses a popup, the current topic remains displayed in the window and the related target appears in a small window over the help window.  When the reader clicks the mouse button again, the popup window closes.

WinHelp provides over 50 macros, or commands, that are available to anyone.  You can choose to run a macro when the project is opened, when a particular topic is accessed, or on a hotspot.  You can use ForeHelp to create multimedia hypertext documents, combining text, graphics, sounds, and video.  If you have your own DLL file of macros, you can register those with ForeHelp and use them as you would WinHelp’s macros.

ForeHelp provides a number of tools to make working with your help projects easier.  You’ll find a thesaurus and a spell checker--you can even check the spelling of macro arguments and keywords.  Find not only helps you find the text you are looking for, but also helps you place a hotspot on it, so you can quickly create connections between topics.


ForeHelp Edit Name Dialog Box
ForeHelp Edit/New Name Dialog Boxes

This topic contains the following sections:

Edit Name Dialog Boxes

Enter New Name Dialog Boxes

Edit New Name Dialog Boxes

The ForeHelp edit name dialog box appears whenever you select an entry from a list box and choose the Change button in a dialog box, such as the Edit Master Keywords dialog box or the Window Classes dialog box.  The selected entry from the previous dialog box appears in the Old Name and New Name fields.  Click in the New Name field and type in a new entry.  When you choose the OK button, the new entry appears in the list box of the previous dialog box.

Edit Context Map File Name	Change the spelling of the name of an existing context map file.  See Adding, Changing, Deleting Map Files.

Edit Browse Sequence Name	Change the spelling of the name of a browse sequence.  See Creating and Modifying a Sequence Name.

Edit Window Class Name	Change the spelling of the name of a window class.  See Creating and Deleting Window Classes.

Edit Keyword 	Change the spelling of a keyword in the master keyword list.  See Changing Keywords.

Click on the parts of the box below where [image] appears for explanations of features.

Enter New Name Dialog Boxes

The ForeHelp new name dialog box appears whenever you choose the New button in a dialog box, such as the Edit Master Keywords dialog box or the Window Classes dialog box.  This dialog box is similar to the edit name dialog box shown below, except that it provides only the New Name field.  Click in the New Name field and type in a new entry.  When you choose the OK button, the new entry appears in the list box of the previous dialog box.

Enter New Keyword Name	Allows you to add a new keyword to the master keyword list.  See Adding Keywords to Master List.

Enter New Context Map File Name	Allows you to add the name of a new context map file to your ForeHelp project.  See Adding, Changing, Deleting Map Files.

Enter New Window Class Name	Allows you to add a new secondary window class.  See Creating and Deleting Window Classes.

Enter New Browse Sequence Name	Allows you to add a new browse sequence name to your project.  See Creating and Modifying a Sequence Name.

Click on the parts of the box below where [image] appears for explanations of features.


ForeHelp Help Conventions

ForeHelp uses the standard WinHelp conventions and the following conventions in this help application text:

Words in italics	Refer to the names of fields, boxes, and buttons within a dialog box.

Bold instructions	Indicate keystrokes that you enter as shown, or commands that you select from a menu.

Menu|Command	Refers to the name of a menu and a command that appears within that menu.  For example, File|Open means "from the File menu, choose the Open command."

For an Explanation of Dialog Box Options

Wherever a picture of a dialog box is included in this help file, the fields, list boxes, check boxes, and buttons on the dialog box picture are hotspots.  As you move the mouse pointer over a hotspot, the pointer becomes a hand cursor.  When this happens, click the mouse button to display a popup window that explains the associated dialog box option.

Terminology

Help window	Refers to your finished product as displayed by WinHelp.

WinHelp window	Same as Help window.

ForeHelp window	Refers to the workspace in which you write your help text using ForeHelp.


ForeHelp Projects

This topic contains the following sections:

To Display the Last Project on Startup

To Display the New/Open/Open As Template Dialog Box on Startup

A ForeHelp help project consists of a series of database files.  ForeHelp assigns the extensions .DBA through .DBG to the file name you assign to the project.  Do not delete any of these files while working on the project.  See Understanding ForeHelp Project Files.

Start ForeHelp by double-clicking on the ForeHelp icon in the ForeHelp program group.  The ForeHelp window appears with one of the following items, depending on how ForeHelp was closed the last time and on its preferences settings:

The New/Open/Open As Template dialog box, in which you can open an existing help project or create a new help project

The Contents topic of the previously opened help project, if the preferences are set and the project was closed properly

A ForeHelp message with options for proceeding, if the preferences are set and ForeHelp could not open the previously edited help project.  See Opening a Damaged Help Project.

You can have multiple copies of ForeHelp running at the same time.  Each copy of ForeHelp must open a different help project.  In this way, you can have multiple databases open simultaneously.

To Display the Last Project on Startup

You can have ForeHelp attempt to display the previously opened help project whenever you start ForeHelp.

1.	Choose the File|Preferences command to access the Preferences dialog box.

2.	Check the Open Last Project box.

3.	Choose the OK button.

4.	When you exit ForeHelp, do not use the File|Close command to close the project.  Simply choose the File|Exit command.
ForeHelp saves all changes made to the project, closes the project, and exits.

To Display the New/Open/Open As Template Dialog Box on Startup

You can have ForeHelp always display this dialog box on startup.

1.	Choose the File|Preferences command to access the Preferences dialog box.

2.	Clear the Open Last Project box.

3.	Choose the OK button.

or

1.	Choose the File|Close command to close the project before exiting ForeHelp.


ForeHelp Window

The ForeHelp window is the workspace in which you create a help project.  Many of the ForeHelp Window's components, such as the format bar, ruler, and status line, may seem familiar to you from using other Windows products.  You can alter the appearance of this window by modifying the toolbar, and by removing the toolbar, the format bar, the ruler, and/or the status line.  See Using the Toolbar, Using the Format Bar, Using the Ruler, and Using the Status Line.

You can maximize the ForeHelp window or restore it to its pre-maximized size.  When you resize the ForeHelp window, ForeHelp remembers the last size of the window each time it starts.

Click on the parts of the box below where [image] appears for explanations of features.


Format Bar

The format bar appears on the ForeHelp window below the toolbar and above the ruler (if displayed).  The format bar contains drop-down list boxes for the font name, font size, and style name for the text where the cursor is located.  You can change fonts, sizes, and styles by selecting from these lists.  There are also buttons for assigning or removing bold, italics, and underlines to or from the selected text.


Format Menu

Command	Keyboard	Toolbar	Description
Character...			Changes fonts via the Character Format dialog box for selected text.
Paragraph...			Changes paragraph formats via the Paragraph Format dialog box for selected paragraphs.
New Style...			Creates and applies new paragraph styles via the New Style dialog box.
Edit Style...			Modifies an existing paragraph style via the Edit Style dialog box.
Apply Style...			Applies a defined style to the selected paragraph(s) via the Apply Style dialog box.
Delete Style...			Removes a style from the style list via the Delete Style dialog box.
Revert			Reverts selected text to original style characteristics.
Table Cells...			Formats selected cells in a Table via the Cell Properties dialog box.


Formatting Tables

This topic contains the following sections:

To Format Cells

To Add Borders to a Table

To Format Cells

When you format or reformat a large table, ForeHelp indicates its progress by displaying the row and column numbers in the status bar.

1.	Select the cells to format.

2.	Choose the Format|Character or Format|Paragraph command to access the Character or Paragraph Format dialog boxes.

3.	Add borders to your table cells by using the Paragraph Format dialog box.

To Add Borders to a Table

You add borders to a table by adding borders to each paragraph in the table.  You cannot add borders to the cell itself.  When you use borders, ensure that each cell contains only one paragraph.  Try adjusting the left or right margins of the paragraphs to bring the borders of the paragraph closer together or overlapping.  See Creating Borders for instructions on adding borders to paragraphs.


Formatting Text

This topic contains the following sections:

To Format Paragraphs

To Format Characters

To Format Paragraphs

Create and apply styles to new or existing paragraphs.  See Styles.

To Format Characters

1.	Select the range of characters you want to format.

2.	Choose the Format|Character command, press [image] [image], or click on the [image] toolbar button to access the Character Format dialog box.

3.	Make the desired Font, Font Style, Size, and Effects changes.

4.	Choose the OK button.
The selected text reflects the changes.

Important:  Changes made in the Character Format dialog box for selected text overrides style settings of the same options.  To reverse any such local changes when trying to apply a style, select the text, and press [image] [image] or the [image] toolbar button to revert the text.  See Apply Style.


Formatting Tools

The formatting tools appear in the format bar of the ForeHelp window, just above the topic workspace.  The tools include drop-down list boxes for applying font and font size to selected text; buttons for applying bold, italics, and underlines to selected text; and a drop-down list box for applying style to a selected paragraph.  See Using the Format Bar for instructions.


Generate Manual Dialog Box

Access the Generate Manual dialog box by choosing the Project|Generate Manual command.

Click on the parts of the box below where [image] appears for explanations of features.


Generating Manuals

Each time you open the Generate Manual dialog box, ForeHelp displays the settings either that you explicitly saved during the last time you used this dialog box or that you used the last time you generated a manual.

To Generate a Manual

1.	Choose the Project|Generate Manual command to access the Generate Manual dialog box.

2.	Specify the .RTF file:

a)	Choose the RTF File button to access the Select or Create .RTF File dialog box.  This is a standard Windows file open dialog box.

b)	Select the drive and directory for the .RTF file, if desired.

c)	In the File Name field, enter the name of a new .RTF file or select an existing file that will be overwritten.

d)	Choose OK in the Select or Create .RTF File dialog box.

3.	Select and organize topics:

a)	From the All Topics list, select a topic that you want to include in the manual and choose the Add button.  Or choose the Add All button to select and add all topics simultaneously.  As you select a topic, ForeHelp removes it from the All Topics list and adds it to the Topics list.

b)	To organize the topics in the order you want them to appear in the manual, select a topic in the Topics list and choose the Up or Down button to move the topic to its appropriate location.

c)	To alphabetize the topics in the list, choose the Alphabetize button.

d)	To remove topics from the Topics list, select the topic and choose the Remove button.  ForeHelp removes the topic name from the Topics list and adds it to the All Topics list.  Alternatively, you can choose the Remove All button to remove all topics from the Topics list.

4.	Decide how to handle popup topics, if desired:

a)	To collate popup topics into a glossary that appears at the end of the manual, check the As Glossary box in the Collate Popups section.  Each glossary entry contains the text of the hotspot and the text of the destination topic.  If you also want to include the title of the topic, check the Add Title to Entry box.

b)	To collate popup topics into footnotes that appear at the bottom of the appropriate pages, check the As Footnotes box in the Collate Popups section.

5.	Specify a hotspot text option, if any:

a)	To change the appearance of the text that is used as a hotspot in the help project, choose the Font button next to Jumps or Popups.  The Character Format dialog box appears.

b)	Make the changes in the Character Format dialog box that you want.

c)	Choose OK in the Character Format dialog box.  ForeHelp checks the box next to Jumps or Popups to indicate that this type of hotspot has format changes applied.  When you generate the manual, ForeHelp applies these changes to the hotspot text within the manual .RTF file.  If you don't specify a format change, the hotspot has the same font characteristics as its surrounding text.

6.	Specify where you want automatic page breaks inserted:

You can have ForeHelp insert hard page breaks between each help topic or just prior to a paragraph that has a specific style.  You can use these options in combination.

a)	To insert a page break between each help topic, check the Break On Topics box.

b)	To insert a page break prior to a specific style, select the style name(s) in the Break on Styles list box.

7.	Choose the OK button to start the generation of the manual .RTF file.  ForeHelp displays the Generate Manual Status box with messages about the starting time of the manual generation, error messages, and completion time.

If you want to save your settings in the Generate Manual dialog box but not generate the manual yet, choose the Save button and then choose the Cancel button.

Choose the Cancel button only to close the dialog box without saving the settings.


Generating Reports

This topic contains the following sections:

To Access the Reporter

To Generate a Report on Selected Topics

To Generate a Project Keyword Report

To Generate a Project RTF File Report

To Generate a Project Statistics Report

To Access the Reporter

1.	Choose the Tools|Reporter command, or click on the [image] toolbar button to access the Reporter Options dialog box.

2.	Select the options for the report.  See the following for instructions:
To Generate a Report on Selected Topics
To Generate a Project Keyword Report
To Generate a Project RTF File Report
To Generate a Project Statistics Report

3.	Select other options for the project or choose the OK button.  The Reporter generates the report for the selected fields and topics.  It displays the report in the Reporter window.  See Printing Reports.

To Generate a Report on Selected Topics

1.	In the Topics list box, select the topic titles for which you want to generate a report or choose the Select All button to select all topic titles at once.

2.	In the Fields list box, select the types of information that you want to display:

Field	Description

Context Strings	The topic's context string as set in the Topic Properties dialog box.

Context Number	Context number and map file, if set in either the Topic Properties dialog box or Context Mapping dialog box.

Browse Sequence	If the topic is a member of a browse sequence, the sequence name prints, otherwise the entry is None.

Has Banner	The entry is Yes if the topic has a banner and No if it does not.

#Jumps	The number of jumps from the topic.

Jumps To	A list of topics, targets, and aliases to which jumps are made.

#Popups	The number of popups from the topic.

Popups To	A list of topics, targets, and aliases to which popups are made.

#Topic Macros	The number of topic macros assigned to the topic.

Topic Macros	A list of the macro statements assigned to the topic.

#Keywords	The number of keywords assigned to the topic.

Keywords	A list of the keywords assigned to the topic.

RTF File	The name of the RTF file associated with the topic as set in the Topic Properties dialog box.

To Generate a Project Keyword Report

1.	To list all of the project keywords alphabetically, check the Show Keyword List box.

2.	To list the keywords alphabetically and list the topics where each keyword is contained, check the Show Keyword Topics box.
Note: Checking both boxes provides the same report as if you checked only the Show Keyword Topics box.

To Generate a Project RTF File Report

1.	To list all of the RTF files associated with this project, check the Show RTF File List box.

2.	To list all of the RTF files and the topics assigned to each file, check the Show RTF File Topics box.
Note: Checking both boxes provides the same report as if you checked only the Show RTF File Topics box.

To Generate a Project Statistics Report

1.	Choose the Statistics button to access the Statistics dialog box.

2.	Check one, any, or all of the following options, or choose the Select All button to check all boxes at once:

Option	Description

Topic Count	The total number of topics in your project.

Project Title	Title of the project as set in the Project Properties dialog box.

Database File Sizes	Size in bytes of each database file (.DB*) in the project.

Project Macros 	List of the macro commands that run when the final help file is opened.

Total Keywords	The total number of keywords used in the project.

Browse Sequences	Alphabetical list of the names of the browse sequences defined in the project.

Build Directory 	Name of the directory where ForeHelp searches for and places the files created during the build process, as specified in the Project Paths dialog box.

Text Path	Name of the directories where ForeHelp searches for text files and places any created text files, as specified in the Project Paths dialog box.

Graphic Path 	Name of the directories where ForeHelp searches for graphics files and places any created graphics files, as specified in the Project Paths dialog box.


Glossary

#define

#include

$FILENAM.DBA

A

Accelerator Key

Alias

B

.BAS

.BMP

Baggage Files

Banner

Banner Base Style

Base Style

Browse Sequence

Build

C

Cell

Clipboard

Compile

Contents

Context Map File

Context Number

Context String

Context-Sensitive Help

D

.DBA

.DIB

Disconnected Target

DLL

Detail, Text

E

Embedded Window

F

.FHB

FHXXXXXX.DBA

Find

ForeHelp

FOREHELP.INI

Formatting Tools

G

Grapher

H

.H

.HLP

.HPJ

.HPP

Hotspot

Hypertext

I

.ICO

Insert

Interfile Jump

Interfile Popup

J

Jump

K

Keyword

M

Macro

.MRB

N

Navigator

Nonscrolling area

P

Paragraph

.PAS

Picture

Popup

R

.RTF

Reporter

S

.SHG

Search

Secondary Window

Spell Check

Style

T

.TXT

Tables

Target

Test

Text Detail

Thesaurus

Toolbar

Topic

W

.WMF

WIN.INI

Window Classes

WinHelp


Goto Dialog Box

This topic contains the following sections:

To Display Another Topic

Goto Dialog Box

The Goto dialog box enables you to quickly open any topic within your project.  It lists all of the topics in your project alphabetically and numerically by topic title.  Titles beginning with special characters appear at the top of the list, followed by titles beginning with numbers, and then titles beginning with letters.

You can also choose to display the targets and aliases defined in the project.  The context strings of the targets appear indented beneath the title of the topic containing the target.  The aliases appear at the end of the topic list.  Each alias begins with --> and is listed alphabetically by name.

You can choose to display the topics using only their context strings.  ForeHelp does lists the topics alphabetically by context string.  If you also check Show Targets and Aliases, ForeHelp includes the context strings of the targets and aliases in the alphabetical order along with the topic context strings.

To Display Another Topic

1.	Choose the Topic|Goto command, or press [image] [image], or click on the [image] toolbar button.  ForeHelp displays the Goto dialog box, which lists all topic titles used in your project.

2.	To list all targets indented under their topics and to list all aliases at the end of the topic list, check the Show Targets and Aliases box.

3.	To list targets by context string rather than by topic title, check the Show Context Strings Only box.

4.	Move through the list using the scroll bar or by typing the first character of the topic.  Each time you type a character, the cursor jumps to the next entry beginning with that character.

5.	Select a topic or target and choose the OK button.
Or double-click on a topic or target.
The topic appears on your screen at the start of the topic (default target) or at the target location.

Goto Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Grapher

This topic contains the following sections:

To Change the Topic Displayed in Grapher

To Change Default Display Levels and History Depth

The Grapher lets you view your overall project in a hierarchical tree structure with branching.  You can see links between topics and relative levels of topics (siblings, parents, children).  Black squares mean that the display can be expanded into more branching.  Gray squares mean that the topic is a duplicate, and its branching exists elsewhere in the graph.  Disconnected topics (not linked to any other topic) display at the bottom of the graph.  You can delete disconnected topics if they are not used anywhere or link them as desired.

Choose the Tools|Grapher command or click on the [image] toolbar button to access the Grapher Window.  The default topic displayed is Contents.

To Change the Topic Displayed in Grapher

Double-click on a topic name to display its branch(es), or

Click in the Grapher History drop-down list box and select a previous view, or

In the main ForeHelp window, go to the desired topic then display the Grapher and choose the Options|Reset to Main Window's Topic command or click on the [image] button.

To return to the Contents topic, choose the Options|Reset to Contents command or click on the [image] button.

To Change Default Display Levels and History Depth

1.	From ForeHelp's main menu bar, choose the File|Preferences command to display the Preferences dialog box.

2.	Change Grapher settings as desired using the incrementers or by selecting the entry and typing a new value.  The default number of levels is 5 and the default history depth is 20.


Grapher Definition
Grapher

Grapher is a ForeHelp tool that draws a graph of topic associations in hierarchical form.  Access the Grapher window by choosing the Tools|Grapher command or by clicking on the [image] toolbar button.


Grapher Window

Click on the parts of the box below where [image] appears for explanations of features.


Help Author Provides Context Numbers

This topic contains the following sections:

To Assign a Context Number to New Topics

To Assign a Context Number to New Targets

To Assign Context Numbers to Existing Topics/Targets

To Assign Context Numbers to All Existing Topics Automatically

To Assign Aliases with Context Numbers

When you assign context numbers to the topics to be used as context-sensitive help, the application programmer must assign the corresponding numbers to the dialog boxes in his code to call help.  You can add context numbers systematically in several ways or have ForeHelp assign numbers to all topics and targets within your project.  If you have a large number of topics and targets needing context numbers, you can have ForeHelp organize groups of context numbers and strings into Context Map Files.  To create the map files, see Exporting Context Map Files.

To Assign a Context Number to New Topics

1.	When you create a new topic, ForeHelp displays the Topic Properties dialog box.

2.	Enter a context number in the Context Number field or click the up arrow to select the next available context number.

3.	Select a file name for a context map file or enter the name of the file in the Context Map File field to organize your numbers into files.

To Assign a Context Number to New Targets

1.	When you create a new target, ForeHelp displays the Insert Target dialog box.

2.	Enter a context number in the Context Number field or click the up arrow to select the next available context number.

3.	Select a file name for a context map file or enter the name of the file in the Context Map File field to organize your numbers into files.

To Assign Context Numbers to Existing Topics/Targets

1.	Choose the Project|Context Mapping command to access the Context Mapping dialog box.

2.	Select each topic in turn, enter a context number or click the up arrow to select a number in the Context Number field.

3.	Select a file name for a context map file or enter the name of the file in the Context Map File field to organize your numbers into files.

To Assign Context Numbers to All Existing Topics Automatically

1.	Choose the Project|Auto-Generate Context Numbers command, or click on the [image] button on the toolbar.

If you have previously assigned context numbers to some topics or targets, ForeHelp retains these numbers and assigns context numbers only to topics without numbers.  If you have deleted topics that had context numbers assigned and do not have any jumps or popups to the deleted topics, ForeHelp reuses these numbers.

To Assign Aliases with Context Numbers

1.	Choose the Project|Aliases command to access the Project Aliases dialog box.

2.	Add or edit an alias.

3.	Assign a Context Number in the Edit Alias dialog box.


Help Buttons
ForeFront Help Buttons
ForeHelp Add-on Product

You can create your own button for your help file quickly and easily using ForeFront Help Buttons.  When used with ForeHelp, you choose button options from standard Windows-style dialog boxes.  You can create a custom button specifying text (in any font) or a bitmap graphic for the button face.  Choose from button template styles provided with ForeFront Help Buttons or create your own templates to use again and again.  You can place your button anywhere in the help file: in topic text, in the banner, or even simulating a button bar in a secondary window.

To order, click on the Order Form button, print the ForeFront Order Form, complete it, and send to ForeFront.


Help Menu

Command	Description
Contents	Displays the help file for the application at the Contents topic.
Search for Help On...	Displays the Search dialog box so you can search for topics containing keywords.
Keyboard Shortcuts	Displays a list of Keyboard Shortcuts.
How to Use Help	Displays the Windows' "How to Use Help" file.
About ForeHelp	Displays the copyright and software version of ForeHelp and the serial number of your copy of ForeHelp.


Help Units
Help Unit

A help unit is WinHelp's method of describing the size of the screen in a manner that is independent of the screen's resolution.  WinHelp always assumes that the size of the screen is 1024 help units wide by 1024 help units high.  You use help units as the values of the PositionWindow macro parameters that describe the location and size of the window.  For example, to describe a window that is half the height and three-quarters the width of any screen, you set the height parameter to 512 help units and the width parameter to 768 help units.


Hotspot

A hotspot is an area highlighted in a topic, which carries out an action such as bringing related topic text into view or running a program.  A hotspot is either a jump, a popup, or a macro.  To activate a hotspot in a WinHelp window, click on it or press [image] while it is highlighted.  To activate a hotspot in a ForeHelp window, press the [image] key and move the mouse cursor over the hotspot.  When the cursor changes to [image], click on it.


Hypertext

Hypertext documents are files created in an electronic format that has advanced reference and linking tools, allowing the reader to move from one portion of the document to a related portion quickly and easily.  WinHelp documents are a form of hypertext.


Import Status Window

The Import Status window displays messages related to the importing of an .RTF file or the opening of an .HPJ file.  ForeHelp displays messages to indicate its progress in importing the file.  As ForeHelp deletes or maps styles from the .RTF file, it displays appropriate warning messages.


Insert

Insert is the act of bringing files created in other software programs into ForeHelp for use in a help project.


Insert Special

This topic contains the following sections:

To Display the DLL List

To Insert a Special DLL

To Add Your Own ForeHelp-Compatible DLL to the ForeHelp Menu

ForeHelp provides a dynamic link library (DLL) that provides support for 256-color bitmaps.  ForeHelp also provides the capability of adding other DLLs that you can use with ForeHelp.  When you use these special DLLs, ForeHelp inserts the embedded windows for you and displays the appropriate dialog box (if any) required by the DLL.

When you obtain additional DLLs from ForeFront, Inc., the DLL setup program installs the DLL so that its name automatically appears on the Insert Special menu.  ForeHelp also provides a help file with instructions for using the DLL.  You can install other ForeHelp-compatible DLLs and modify the FOREHELP.INI file to display the DLL name on the Insert Special menu.

To Display the DLL List

1.	Choose the Text|Insert Special command.  A secondary menu containing the installed DLLs appears to the right of the Text menu.

To Insert a Special DLL

1.	Choose the Text|Insert Special command.

2.	From the secondary menu, choose the name of the DLL that you want to insert.
ForeHelp displays the appropriate dialog box for the DLL.

3.	Complete the DLL's dialog box appropriately.  Use the Help button on the dialog box to access the help file for the DLL.

To Add Your Own ForeHelp-Compatible DLL to the ForeHelp Menu

1.	Open the FOREHELP.INI file using a text editor.

2.	In the [Special Menu] section, add a line using the following format:

title=dll_name.dll,parameter

title	The text that you want to display on the Insert Special menu

dll_name.dll	Name of the DLL file

parameter	Any parameter(s) required by the DLL that you want to set up for automatic assignment.  Separate parameters with commas and omit spaces.


Inserting Bullets

This topic contains the following sections:

To Insert Bullets

To Repeat Bullet Insertion

To Delete Bullets

To Modify Bullets

Bullets And Numbering Dialog Box

The first time you insert bullets, you must use the Bullet And Numbering dialog box.  After you have set up the dialog box for the bullet picture and paragraph style that you want to use, you can then click on the [image] toolbar button to insert additional bullets of the same design.

When you insert bullets, ForeHelp inserts a bitmap graphic and tab at the start of each selected paragraph.  There is a .25 inch space between the graphic location and the start of the first line.  You can choose to retain the existing paragraph style, create a hanging indent margin and retain the remaining style attributes, or use ForeHelp's List styles.  For examples, see Bullet and Number Examples.

Important	The bullet pictures provided with ForeHelp are black graphics on a white background.  If you insert these bullets on colored background or colored banner, the white picture background shows up.  You can use a bitmap editor to create a new bullet picture with the appropriately colored background.

To Insert Bullets

1.	Place the text cursor in the paragraph at which you want to insert a bullet or select the paragraph(s) that comprise your bulleted list.

2.	Choose the Text|Insert Bullets command to access the Bullet And Numbering dialog box.

3.	Check the Bullet option.  A list box appears with the list of bullet pictures available for your project.

4.	Select a bullet picture from the list.

5.	Select a paragraph style option:

No Indent	Retains the paragraph style.  The first line starts at the first tab position of the paragraph.

Hanging Indent	Sets the first line indent at the left edge of the window and sets the left margin at .5 inch.  Any other style definitions of the selected paragraph remain the same.

Use List Style	Applies the List1 style to the selected paragraph.

6.	Choose the OK button.  ForeHelp inserts bullet(s) at the designated location(s).

To Repeat Bullet Insertion

ForeHelp remembers the last bullet or number that you inserted using the Bullet And Numbering dialog box.  You can insert another bullet without accessing this dialog box.

1.	Insert one or more bullets following the steps in To Insert Bullets.

2.	Place the cursor where you want to insert another bullet.

3.	Click on the [image] toolbar button to insert another bullet.

Warning: When you use this button, ForeHelp inserts the last bullet or number selection that you made in the Bullet And Numbering dialog box.

To Delete Bullets

1.	Select the bullet.

2.	Press the [image] key.

To Modify Bullets

1.	Select the paragraph(s) containing the bullets.

2.	Choose the Text|Insert Bullets command to access the Bullet And Numbering dialog box.

3.	Select a different bullet picture from the list.

4.	Choose the OK button.  ForeHelp replaces the existing bullet(s) with the new design.

Bullets And Numbering Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Inserting Pictures

This topic contains the following sections:

To Insert a Picture File

Insert Picture Dialog Box

You can insert bitmaps (.BMP or .DIB files), metafiles (.WMF), multiple resolution bitmaps (.MRB), or sheg (.SHG) files into your help project.  ForeHelp displays the picture in the ForeHelp window.  If you click once on the picture, a field named Picture appears on the right side of the status line and displays the path (if different from the project's path) and name of the graphic file for this picture.

To Insert a Picture File

1.	Place the cursor where you want to insert the picture.

2.	Choose the Text|Insert Picture command or click on the [image] toolbar button to access the Insert Picture dialog box.

3.	In the List Files of Type drop-down list box, select the correct picture type.

4.	In the Directories and Drive fields, select the appropriate drive and directory in which the picture is located.

5.	In the File Name field, select the name of the graphic file.
ForeHelp displays the picture in the sample box in the lower right corner of the dialog box.  If the picture is larger than the sample box, ForeHelp scales it to fit the box.  If the picture is smaller, ForeHelp centers it within the box.

6.	In the Placement section, check the option for how ForeHelp will place the picture in your topic (See Working with Pictures in Text for more information and examples.):

Character	The graphic is placed on the current line as if it were a character.

Left	The left edge of the graphic is placed at the From Left indent setting in the Paragraph Format dialog box (the left margin icon on the ruler).

Right	The right edge of the graphic is placed at the From Right indent setting in the Paragraph Format dialog box (the right margin icon on the ruler).

7.	If your picture is smaller than 64K, select an option in the Storage Method section to tell ForeHelp how to handle this picture when it compiles the final .HLP file:

Best for Speed	ForeHelp places a copy of the picture in each place that it occurs.  This allows WinHelp to display the picture very quickly, but the tradeoff is that your .HLP file is larger.

Best for Size	ForeHelp stores one copy of the picture, then places a reference to that copy in each place that the picture is used.  This makes the .HLP file smaller, but it takes a little longer for WinHelp to display the picture.

If your picture is larger than 64K, ForeHelp always uses Best for Size.

8.	Choose the OK button.
ForeHelp displays the image in the ForeHelp window.  To add hotspots to the picture, see Putting Hotspots on Pictures.

Insert Picture Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Inserting Rich Text Format (.RTF) Files

This topic contains the following sections:

To Insert an .RTF File

RTF Import Options Dialog Box

These instructions are separated into three topics.  This topic describes the basic steps for inserting an .RTF file.  The second topic describes the import options you choose to recreate a help file (see Recreating a Help File from an RTF File).  The third topic describes the import options you choose to insert an .RTF file from a word-processing package (see Inserting a Manual's .RTF File).

To Insert an .RTF File

1.	Choose the Text|Insert File command.  ForeHelp displays the Insert File dialog box, which is a standard Windows file open dialog box.

2.	Select .RTF File in List Files of Type.

3.	Select the drive and directory where the file is located.

4.	Select the name of the file.

5.	Choose the OK button.
ForeHelp closes the Insert File dialog box and displays the RTF Import Options dialog box.

6.	In the Common Named Styles section of the RTF Import Options dialog box, select an option for handling styles with the same name in the .RTF file and the ForeHelp project:

Use ForeHelp's Styles	Overrides the definitions in the .RTF file with the definitions in your ForeHelp project.

Use RTF File Styles	Overrides the definitions in the ForeHelp file with the definitions in the .RTF file.

Keep Both Styles	Appends a number to the style name in the .RTF file, such as Base-1.

7.	You can map styles in the .RTF file to styles in the ForeHelp project and/or designate certain styles as the start of a new topic.  When you do this, ForeHelp records this information in the FOREHELP.INI file so that it's available for you to use with other .RTF files or in other help projects.  You can map multiple .RTF styles to a single ForeHelp style.

a.	Select an .RTF style in the Styles list box in the Style Options section.

b.	In the Map To Style drop-down list box, select the ForeHelp project style that you want to use in place of the selected .RTF style.

c.	Repeat steps 7a and 7b to set up all your mappings.  When you choose the OK button to close this dialog box, ForeHelp writes these mappings to the FOREHELP.INI file for later use.  You can change the mappings later by repeating steps 7a and 7b.

d.	To apply one or more of the mappings to the file that you are inserting, check the box next to the .RTF style in the Styles list box.  To check or to clear all styles simultaneously, choose the Select All Styles button.

8.	Select other options depending on whether you are inserting a help .RTF file or a hardcopy manual .RTF file.  (See Recreating a Help File from an .RTF File or Inserting a Manual's .RTF File.)

9.	Choose the OK button.
ForeHelp starts to insert the file and displays the Import Status window with messages about the status of this operation.

10.	If you created new topics from the .RTF file, you can choose the Topic|Goto command, press [image] [image], or click the [image] toolbar button to view all topic names and to go to any topic.  By default, the topic name is the first 50 characters of the first line in the topic.  if the first line is blank, ForeHelp names the topic RTF######, where ###### is a randomly generated number.  You can go to the topics with the ForeHelp-assigned names, choose the Topic|Properties command, and type a new name in the Topic Title field.

RTF Import Options Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Inserting Text (.TXT) Files

This topic contains the following sections:

To Prepare a .TXT File for Insertion

To Insert a .TXT File

To Create Separate Topics from a .TXT File

Almost every word processor lets you create ASCII text files.  These files contain plain text without character and paragraph formats.  ASCII files usually retain tabs, paragraph markers, line breaks, and hard page breaks.

When you insert a text file, ForeHelp places the first 55 Kbytes of data into the current topic and automatically wraps paragraph text appropriately.  If the file contains a hard page break, all text after the first hard page break is not inserted.  If the file contains line breaks, the line breaks are retained and the paragraphs might not wrap correctly within the help file.

To Prepare a .TXT File for Insertion

1.	Remove all line breaks and hard page breaks in the file.

2.	Save the file as text only (without line breaks).  If you insert a text file with line breaks, the paragraphs might not wrap correctly within the help file.

To Insert a .TXT File

1.	Open or create a ForeHelp project using the File|New/Open command.

2.	Choose the Topic|Goto command, press [image] [image], or click on the [image] toolbar button to display the topic where you want to place the inserted text.

3.	Place the cursor at the location for the text to be inserted.

4.	Choose the Text|Insert File command.
ForeHelp displays the Insert File dialog box, which is a standard Windows file open dialog box.

5.	Select .TXT File in List Files of Type.

6.	Select the drive and directory where the file is located.

7.	Select the name of the file.

8.	Choose the OK button.
ForeHelp inserts the entire .TXT file at the cursor location in the current topic.  If ForeHelp encounters a hard page break in the .TXT file, it does not insert any text following the hard page break.

To Create Separate Topics from a .TXT File

There are two ways to create separate topics from a .TXT file, either before insertion or after insertion into your help project.

Before Insertion:

1.	Create a separate .TXT file for each new topic.

2.	In ForeHelp, create a new topic corresponding to one of the .TXT files.

3.	Insert the corresponding .TXT file.

4.	Repeat these steps for each topic.

After Insertion:

1.	After inserting the .TXT file, select the portion of the inserted topic text that you want to move to a new topic.

2.	Press [image] [image] to cut the text to the Clipboard.

3.	Press [image] [image] to create a new topic and enter the new topic information.

4.	Press [image] [image] to paste the data into the new topic.

5.	Press [image] [image] to return to the topic you came from.

6.	Repeat these steps until you have cut and pasted all the text to the appropriate topics.


Inserting a Manual's .RTF File

This topic contains the following sections:

To Prepare an .RTF File for Insertion

To Insert a Manual's .RTF File

To Change .RTF File Associations

You can easily convert a hardcopy version of a manual to a help file.  This topic provides some tips and guidelines for setting up your hardcopy manual before creating an .RTF file and steps for inserting the file into your ForeHelp project.

To Prepare an .RTF File for Insertion

1.	Using your word processing software, open the file you want to insert into ForeHelp.

2.	Visualize how you want this file to appear in ForeHelp.  For example, you might want to create topics from each major heading and from the first level of subheadings.  Or you might want to have each entry in a glossary become a separate topic.

3.	To create new topics before each paragraph that has a particular style assigned to it, ensure that you have designated all such paragraphs with the appropriate style name(s).  You can select multiple style names for new topics.  ForeHelp creates a new topic each time that it encounters a paragraph with the selected style.  Ensure that you have not assigned this style to other paragraphs that are not intended to start new topics.

4.	To create separate topics without specifying a particular style, insert hard page breaks to mark the end of one topic and the start of another topic

5.	Start each topic with the topic title.  ForeHelp automatically uses the first 50 characters of the first paragraph in the topic as the topic title and context string.

6.	Save the file as .RTF format.

7.	If the file is on a different computer than the ForeHelp project, copy the file to your ForeHelp development computer.

To Insert a Manual's .RTF File

When you insert an .RTF file, you can map the styles from the .RTF file to specific styles in your ForeHelp project.  You can define this mapping for later use and not for this project or you can use it both for this this project and later projects.

1.	Follow the steps in Inserting Rich Text Format (.RTF) Files until step 8.

2.	In the General Options section of the RTF Import Options dialog box, clear the Interpret As Help Format File option.  The Create New Topic options in the Style Options section become available.

3.	If you inserted hard page breaks in your .RTF file to indicate new topics, check the Create Topic At Page Break option.

4.	To replace all of the topics in the current project with the inserted topics, check the Replace Existing Topics options.

5.	To map bullets from the .RTF file to the ForeHelp bullet pictures, check the Map Bullets option.  To define the mapping between the .RTF file and ForeHelp, see Mapping Bullets.

6.	If your manual contains index codes, check the Create Keywords From Index Entries option to convert the index entries to Search keywords.  ForeHelp uses the first two levels of the index entry as the keyword (for example, the entry "keywords, adding" becomes the keyword "keywords: adding").

7.	In addition to setting up mappings between the .RTF file's and your ForeHelp project's styles (see step 7 of Inserting Rich Text Format Files), you can create new topics based on selected styles.  This information is stored in the FOREHELP.INI file so that it's available for the next time that you insert a file into any help project.

a.	Highlight the .RTF style name in the Styles list.

b.	Check the Create New Topic box.  The three options below this box become available.  Check as many as are applicable to your project:

Add To Table Of Contents	Adds the title of the new topic to the Contents topic with a jump to the new topic.

Add Banner	Creates the new topic with a banner and places the topic title in the banner.

RTF File	Associates the new topic with the listed .RTF file.  By default, the .RTF file is the one that you are inserting.  See To Change .RTF File Associations.

c.	Repeat steps 7a and 7b as necessary.  When you choose the OK button, ForeHelp writes this information to the FOREHELP.INI file.

d.	To create topics using one or more of your designated styles, check the box next to the .RTF style name.  Use the Select All Styles button to check or to clear all boxes simultaneously.

8.	Choose the OK button.  ForeHelp recreates the help file and displays the Import Status window.

To Change .RTF File Associations

By default, ForeHelp associates each new topic created from an .RTF file with this file.  This association appears in the Topic Properties dialog box.  This is an association only.  When you build your help project, you can choose to place all topic information into the default .RTF file, you can create several .RTF files using the topic associations, or you can build the project based only on the selected .RTF files.  See Build and Compile.

There are several options for changing .RTF file associations for your topics:

When you insert the .RTF file, you can select another .RTF file already in use by this project.  Click on the down arrow next to the RTF File field to display the list of .RTF files for this project.  Select a file name.

When you insert the .RTF file, you can select or create another .RTF file by choosing the RTF File button.  The Select or Create RTF File dialog box appears, which is a standard Windows file open dialog box.

After you insert the .RTF file, you can go to the topic and choose the Topic|Properties command to access the Topic Properties dialog box.  Change the entry in the RTF File field.


Inserting and Deleting Rows and Columns

This topic contains the following sections:

To Insert Rows and/or Columns

To Add a Row to the End of the Table

To Remove Rows and/or Columns

To Insert Rows and/or Columns

1.	Place the cursor in a cell before which you want to insert a row or column.

2.	Choose Text|Insert a Column or Row as needed.

To Add a Row to the End of the Table

1.	Place the cursor in the last cell of the table.

2.	Press

To Remove Rows and/or Columns

1.	Place the cursor in a cell in the row or column to be deleted.

2.	Choose Edit|Delete a Row or Column as needed.


Interfile Jump

An interfile jump jumps to a target in an .HLP file separate from your current help project.


Interfile Popup

An interfile popup is a hotspot that displays a window from an .HLP file separate from your current help project.


Jump

A jump is a hotspot that replaces the topic in the current window with another topic or with a target within the current topic.  See Jumps and Popups.


Jumps and Popups

This topic contains the following sections:

Overview of Jumps

Overview of Popups

Appearance of Jumps and Popups

Jumps and popups are two types of hotspots that allow the reader to quickly find and move to related information.  You can tell where a hotspot leads by clicking in the hotspot text and noting the target name in the right field of the status line.  If you press the [image] key and click in the hotspot text when the cursor becomes [image], ForeHelp displays the target topic in the ForeHelp window.  See Using Jumps and Popups for related instructions.

The Reporter can display and print the number of jumps and/or popups used in any topic and the titles of the destination topics for the hotspots.

Overview of Jumps

Jumps display the target topic in the main WinHelp window, replacing the current topic.  A jump can also display the target topic in a secondary window (see Window Classes.)  Jumps are the primary way that your reader moves through your help file.  Jumps are often used to display topics that provide instructions, overview material, and graphics such as dialog boxes.  For example, this topic uses a jump to the topic Window Classes because you might want to know how to create secondary windows in your project.

With ForeHelp, you can create jumps to the start of a topic or to targets located at a specific section within a topic.  You can also create jumps to topics or targets within other help files (interfile jump).  For instructions, see Creating Jumps or Creating Interfile Jumps.

Overview of Popups

Popups place a smaller window on top of the WinHelp window.  The popup window closes with any keystroke or mouse click.  For this reason, your reader cannot print a popup topic or copy or annotate the text from a popup.  The popup window cannot scroll and opens to a size that accommodates your text or to the maximum allowed by WinHelp.  Popups are suited for short topics and are often used to provide definitions of terms within topic text or definitions of fields and sections of graphics.

The popup window should not contain a banner.  If you create a popup to a topic that has a banner, WinHelp displays only the banner when the popup is selected.  When you build your help project, ForeHelp warns you of any popups to topics with banners.

You can create popups to topics or targets within the same help file or within other help files (interfile popup).  For instructions, see Creating Popups or Creating Interfile Popups.

Appearance of Jumps and Popups

Within text, WinHelp and ForeHelp typically display jumps as green text with solid underlines and popups as green text with broken underlines.  The reader's system controls the color display in your final help file.  However, you can choose to make the hotspot hidden or to have no color.  When the hotspot is hidden, WinHelp displays it as plain text.  When the hotspot has no color, WinHelp displays a jump with a solid underline and a popup as a broken underline in the same color as the surrounding text.

In the ForeHelp window, ForeHelp displays hotspots in the same manner as WinHelp.  To help you locate hotspots, ForeHelp marks hotspot text with dotted corner brackets when you have text detail turned on.  You can change the color of jumps and popups in your ForeHelp window using the Preferences dialog box.

To avoid cluttering a graphic with hotspot markings, you can make the hotspot hidden.  When text detail is turned on and the hotspot is not hidden, ForeHelp marks a hotspot by enclosing it in a solid-line box.  If the hotspot is not hidden on a graphic, both WinHelp and ForeHelp display it by enclosing it in a broken-line box.


Keyboard Shortcuts

Menu Command Keys

Cursor Movement/Selection Keys


Keyword

A keyword is a word or string that the Search system uses to locate specific information throughout the help project.  The Search system displays a list of topics related to or containing the keyword.  You can select a listed topic to view it immediately.  You can also use text keywords that lead the reader directly to the word within a topic's text.  See Keywords and Search.


Keywords and Search

Like a book's index, WinHelp Search allows the reader to look up keywords to locate specific information in a file.  ForeHelp provides the same Search capabilities for you while you develop your help project.  See Using Search.

ForeHelp supports the assignment of keywords to topics or to specific text within a topic.  Topic keywords lead the reader to the start of the topic that contains the related information.  Text keywords lead the reader to the exact line of text that contains the related information.  You can assign the same keyword to a topic and to text within a different topic.  A keyword cannot lead to both the topic and a text location within the same topic.

You can assign as many keywords to a topic (or text location) and as many topics to a keyword as you like.  Use synonyms for your application's features to assist the reader who may not be familiar with your application's terminology.  ForeHelp's Thesaurus can provide you with common synonyms.

ForeHelp maintains a master keyword list for your help project to ensure consistency in the way you specify keywords.  You can add keywords to topics and the master list using the Topic Keywords dialog box or by selecting text within a topic and clicking on the [image] toolbar button.  (See Adding Topic Keywords.)  When you create a new topic, you can make the topic title a keyword and add it to the master keyword list.  You can also use ForeHelp's Find feature to search automatically for a text string and make it a topic keyword.  You add text keywords by using the Keywords in Text dialog box.  (See Adding Text Keywords.)

The Reporter can display and print a list of keywords for any topic, a list of all keywords in the project with or without the topics in which they appear, and the total number of keywords in your project.


Left Margin

The left margin of a paragraph is the distance from the left edge of the window to the left edge of the text, regardless of the window size.


Manual Generation

ForeHelp provides the capability of generating a hardcopy document from your help project.  The hardcopy document is a Rich Text Format (.RTF) file, which you can open in other applications in Windows. The manual .RTF file is different than the one ForeHelp creates automatically when you build your project.  The project .RTF file contains special codes that the WinHelp compiler requires.  The manual .RTF file omits these codes and includes other items that you selected in the Generate Manual dialog box.

When you generate a manual, you can:

Select and organize the topics that you want to include in the manual

Collate popup topics into a glossary at the end of the document and/or as numbered footnotes at the bottom of each page

Specify a different font or font style (italics or bold) to highlight the popup and jump hotspot in the text

Specify page breaks for each topic and/or before a specific paragraph style

Choose the name of the .RTF file

Retain graphics as bitmaps


Mapping Bullets

This topic contains the following sections:

Bullet List

Bullet Map Word 2.0

To Change the Bullet Mappings

Some word processors convert bullets to the Symbol font in the .RTF file.  Not all Windows systems can display Symbol fonts in a help file correctly.  To avoid this display problem, ForeHelp converts a Symbol bullet to a bitmap picture that it can insert and that WinHelp can display.  You can modify this mapping for Microsoft Word 2.0 in the FOREHELP.INI file.  Word 6.0 bullets are not mapped.

There are two sections in this file that are important.  The [Bullet List] section lists the names of the bullet pictures and the location of the file that contains the picture.  Each time you add a bullet picture (see To Add Bullet Pictures to the Master List), ForeHelp makes an entry in the [Bullet List] section.  The [Bullet Map Word 2.0] section maps a Word SYMBOL code to the name of a ForeHelp bullet picture.

[Bullet List]

diamond=C:\FOREHLP2\BULLET.BMP

arrow=C:\FOREHLP2\BULLETS\ARROW.BMP

large dot=C:\FOREHLP2\BULLETS\DOT_LG.BMP

small dot=C:\FOREHLP2\BULLETS\DOT_SM.BMP

hand=C:\FOREHLP2\BULLETS\HAND.BMP

point=C:\FOREHLP2\BULLETS\POINT.BMP

blue point=C:\FOREHLP2\BULLETS\POINT_BL.BMP

red point=C:\FOREHLP2\BULLETS\POINT_RD.BMP

large square=C:\FOREHLP2\BULLETS\SQUAR_LG.BMP

small square=C:\FOREHLP2\BULLETS\SQUAR_SM.BMP

Dot=C:\FOREHLP2\DOT_SM.BMP

Black Point=C:\FOREHLP2\POINT.BMP

[Bullet Map Word 2.0]

62=Black Point

129=Small Square

168=Diamond

183=Dot

default=Dot

To Change the Bullet Mappings

1.	Look at the codes assigned to the bullets in your .RTF file.  For example, Word 2.0 precedes the character code with the word SYMBOL, as in SYMBOL 62.

2.	Open the FOREHELP.INI file with a text editor.

3.	The [Bullet Map Word 2.0] section lists the SYMBOL codes and the ForeHelp bullet name to which the code is mapped.

4.	Replace the SYMBOL code with the appropriate code for the bullet used in your .RTF file, if necessary.

5.	Replace the name of the ForeHelp bullet picture with another bullet picture name from the [Bullet List] section of the FOREHELP.INI file.


Margin Samples
Margin and Indent Samples

This topic contains the following samples:

Block Paragraph

Paragraph Indent

Hanging Indent

Block Paragraph

To format a block-style paragraph using the ruler, drag the bottom left margin icon and/or the right margin icon to new settings.  The first-line indent icon (top left icon) moves with the bottom left margin icon.

In this sample, the right margin is .5 inch from the right edge of the window and the left margin is .5 inch from the left edge.  To reproduce this sample, move the bottom left icon to 1/2" and the right margin icon to the setting that is 1/2" from the right edge.  (The actual number on the ruler depends on the width of your ForeHelp window.)  To format this paragraph using the Paragraph Format dialog box, enter .5 in. in the From Left field and .5 in. in the From Right field.

Paragraph Indent

To format a standard paragraph where the first line is indented, drag the top left margin icon to setting where you want the first line to start.  In this sample, the left margin is .25 inch from the left edge of the window and the first line is indented .25 inch.  To reproduce this sample using the ruler, move the bottom left icon to 1/4" and then move the top left icon to 1/2".  To use the Paragraph Format dialog box, enter .25 in. in the From Left field and .25 in in the First Line field.

Hanging Indent

The hanging indent sample style works well for bullet or numbered items.  In this sample, the left margin of the paragraph is at .5 inch and the first line is .25 inch to the left of the margin.  To reproduce this sample using the ruler, drag the bottom left margin icon to 1/2".  Then, drag the first line indent (top left icon) 1/4" to the left.

To reproduce this sample using the Paragraph Format dialog box, enter .5 in in the From Left field and -.25 in in the First Line field.

When entering text, type the bullet or a number at the start of the first line.  Then, press the [image] key.  As you enter text for the paragraph after the tab marker, the text wraps to the left margin setting (.5 inch).

You can also use the List1, List2, and List3 styles provided by ForeHelp and use the Text|Insert Bullets command to insert bullets or to number a list of items  See Bullets and Numbered Lists for more information.


Menu Command Keys

This topic contains the following sections:

File Menu

Edit Menu

Text Menu

Format Menu

Project Menu

Topic Menu

Tools Menu

File Menu

Create new or open existing ForeHelp file

Save project

Print topics

Exit ForeHelp

Edit Menu

Undo/Redo last operation

Cut selected text to Clipboard

Copy selected text to Clipboard

Paste from Clipboard

Paste special

Delete selected text

Select all text

Select table

Text Menu

Make jump or edit jump

Make popup or edit popup

Make macro or edit macro

Insert target or edit target

Edit hotspot

Make topic keyword

Hard space

Line Break

Format Menu

Character format

Paragraph format

New style

Apply style

Delete style

Revert text

Project Menu

Project properties

Project macros

Project browse sequences

Build/compile project

Test mode

Launch WinHelp

Topic Menu

Topic properties

Topic keywords

Topic macros

Go to Contents topic

Search dialog box

Back to previous topic

Help History window

Go to previous topic in browse sequence

Go to next topic in browse sequence

Goto dialog box

Go to next topic in Goto dialog box list

Go to previous topic in Goto dialog box list

Copies the current topic to a new topic

Create new topic

Delete current topic

Tools Menu

Find dialog box

Find Again

Thesaurus dialog box


Modifying a Table

This topic contains the following sections:

To Modify Cell Properties

Cell Properties Dialog Box

To Modify Cell Properties

1.	Select the cells to modify.

2.	Choose the Format|Table Cells command or click on the [image] toolbar button to display the Cell Properties dialog box.

3.	Change minimum cell width, space between columns, space from the leftmost gridline to the window margin, and autosizing rows.

Cell Properties Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Modifying and Deleting Pictures

This topic contains the following sections:

To Modify a Picture

To Delete a Picture

You can modify or delete any pictures that you inserted into your ForeHelp project.

To Modify a Picture

1.	Click on a picture in your ForeHelp project to select it.
The vertical bar cursor flashes in the lower left corner of the graphic.  If the graphic file has a name, the Picture field appears on the right side of the status bar, displaying the name and directory of the graphic file.

2.	Choose the Text|Edit Picture command or click on the [image] toolbar button to display the Edit Picture dialog box, which is identical to the Insert Picture dialog box.
If the picture is less than 64 Kbytes in size, the Edit Picture Placement dialog box appears, in which you can modify the placement of the picture.  When you change the placement and choose the OK button, ForeHelp asks if you want to create a file.  When you select Yes to this message, ForeHelp creates a Windows metafile (.WMF) for this picture.  You can now click on the picture to access the Edit Picture dialog box.

3.	Perform one or more of these options:

Select a new Placement option.

Select a different Storage Method, if the file is smaller than 64K in size.

Replace the picture with another by selecting a different file.

Rename the picture's file name and file type.  If the picture has a name, it appears in the File Name box.

To Delete a Picture

1.	Click on a picture in your ForeHelp project to select it.
The vertical bar cursor flashes in the lower left corner of the graphic.  If the graphic file has a name, the Picture field appears on the right side of the status bar, displaying the name and directory of the graphic file.

2.	Delete the picture using the [image] key.


Modifying and Deleting a Browse Sequence

This topic contains the following sections:

To Remove Topics from a Browse Sequence

To Reorder Topics in a Browse Sequence

To Delete a Browse Sequence

To Remove Topics from a Browse Sequence

1.	Choose the Project|Browse Sequences command, press [image] [image] [image], or click on the [image] toolbar button to access the Project Browse Sequences dialog box.

2.	In the Sequence drop-down list box, select the browse sequence name.

3.	In the Topics list box, select the topic to be removed from the sequence.

4.	Choose the Remove button or double-click the topic name.
ForeHelp removes the topic name from the Topics list and displays it in black text in the All Topics list.

To Reorder Topics in a Browse Sequence

1.	Choose the Project|Browse Sequences command, press [image] [image] [image], or click on the [image] toolbar button to access the Project Browse Sequences dialog box.

2.	From the Sequence drop-down list box, select the browse sequence name.

3.	In the Topics list box, select the topic to be moved.

4.	Choose the Up or Down button to move the topic as needed.

To Delete a Browse Sequence

You delete a browse sequence by deleting its name.

1.	Choose the Project|Browse Sequences command, or press [image] [image] [image], or click on the [image] toolbar button to access the Project Browse Sequences dialog box.

2.	Choose the Sequences button or press [image] [image] to access the Sequences dialog box.

3.	In the Sequences list box, select the name of the sequence that you want to delete.

4.	Choose the Delete button.
ForeHelp deletes the name from the Sequences list.

5.	Choose the Done button.
The Sequences dialog box closes and the Project Browse Sequences dialog box becomes active.  All of the topics assigned to the deleted browse sequence appear as black text in the All Topics list.


Moving Among Topics

You can quickly move among topics by using the mouse:

Mouse click	Point at a jump or popup while pressing [image].  Click the mouse button to display the targeted topic.

Or by using any of the following commands on the Topic menu:

Command	Keyboard	Toolbar	Description

Contents	Displays the Contents topic, the first topic ForeHelp creates when you start a new project (or the one you selected later as the Contents in the Project Properties dialog box).

Back	Displays the topic you were in immediately before the current one.  You can continue to go back through the last 40 topics opened since the beginning of your editing session.

History	Displays the Windows Help History dialog box listing all of the topics you have edited with the most recent topic at the top of the list.  You can double-click on any entry in the list to go to that topic.

Previous	Displays the previous topic in the Browse Sequence that contains the current topic.

Next	Displays the next topic in the Browse Sequence that contains the current topic.

Goto	Displays the Goto dialog box listing all topics in alphabetical/numerical order.  Double-click on a topic to go to that topic.

Goto Next Topic	Displays the next topic in alphabetical order (corresponding to the list in the Goto dialog box) from the topic you are in.

Goto Previous Topic	Displays the previous topic in alphabetical order (corresponding to the list in the Goto dialog box) from the topic you are in.


Moving in Text
Moving through Text

The following keystrokes allow you to move the cursor quickly through your text:

One character to the right

One character to the left

One line up

One line down

One word to the right

One word to the left

One paragraph up

One paragraph down

Beginning of the line

End of the line

Beginning of the topic’s first line

End of the topic’s last line

Up one screen

Down one screen


Navigator

The Navigator lets you visually see any topic and its immediate links.  Initially, the Navigator displays three levels of topics horizontally.  Each topic is identified by its topic title and is contained in a rectangle.  In the center is the selected topic.  All topics that contain jumps or popups to the selected topic display to the left of the selected topic; topics that are the destination of jumps or popups from the selected topic display to the right of the topic.  Icons identify whether the connection between the topics is a jump or a popup.

You can increase the number of levels that Navigator displays by clicking the right mouse button in a topic rectangle at either end of the display.  By clicking in a leftmost rectangle, you display the topics that contain jumps to the topic represented by that rectangle.  By clicking in a rightmost rectangle, you display the topics that are destinations of hotspots in the topic represented by that rectangle.  You can display up to 15 levels of connections.  If there are several topics at the end of the display, clicking in one rectangle expands the levels of that branch alone.  Clicking in another rectangle at the same level, closes the first branch and displays the second branch.

The selected topic's relative position in a browse sequence displays vertically.  Navigator shows only the topic that precedes and the topic that follows the selected topic in the browse sequence.  The Navigator also lets you move through topics using the jumps, popups, and browse sequences.

The underline indicates the cursor location for keyboard actions.  The blue highlight indicates which topic is currently displayed in the main ForeHelp window.


Navigator Definition
Navigator

The Navigator is a ForeHelp tool that draws a graphic representation of topic associations.  Access the Navigator window by selecting Tools|Navigator or by clicking on the [image] toolbar button.


Navigator Window

The Navigator window displays three topics horizontally.  The topics on the left (not shown in the following picture) have hotspots leading to the center topic and the center topic contains hotspots that lead to the topics on the right.  The center topic also may be connected to other topics by means of a browse sequence.  These topics are displayed above and below the center topic.

Click on the parts of the box below where [image] appears for explanations of features.


New/Open Dialog Box
New/Open/Open As Template Dialog Box

The New/Open/Open As Template dialog box enables you to create a new help project, open an existing project, or make a copy of an existing project with a new name to use as the basis of a new project.  Choose the File|New/Open command, press [image] [image], or click on the [image] toolbar button to access the New/Open/Open As Template dialog box.

Click on the parts of the box below where [image] appears for explanations of features.


Numbering Multiple Level Lists

This topic contains the following sections:

To Insert Numbers in Multiple Level Lists

Bullet And Numbering Dialog Box: Multi Level Option

ForeHelp can automatically number paragraphs to produce ordered lists with subordinate lists, procedure steps with substeps, and three-level outlines.  You can identify paragraphs of each level with a different style of number: numbers, upper or lower case letters, and upper or lower case Roman numerals.

You can delete and modify multiple-level numbered lists in the same way as single level lists.  See Numbering Single Level Lists for details.

Paragraphs within a multiple level list have numbered lists that are indented beneath another numbered list.  ForeHelp provides up to three levels of numbered lists.  Paragraphs of the same level all have the same margins.  See Bullet and Number Examples.

To Insert Numbers in Multiple Level Lists

1.	Create the paragraphs that you want to number.

2.	Assign the List1 style to the first-level paragraphs, the List2 style to the second-level paragraphs, and List3 style to the third-level paragraphs.

3.	Select the paragraph(s) that comprise your numbered lists.

4.	Choose the Text|Insert Bullets command to access the Bullet And Numbering dialog box.

5.	Check the Multi Level option.  The dialog box changes to display a Standard (1.1.1) check box, Starting At field, and three Level fields.

6.	Choose Standard numbering or select options for each level of list, as follows:

Standard Numbering

a.	To use a numbering scheme where each level identifies its order in its own list and in its parent list, check the Standard (1.1.1) box.  The dialog box changes to remove the level options.

Outline Numbering

a.	To specify a different number type for each level of list, in the Level 1 drop-down list box, select the type of number that you want to use: number, upper case letter, lower case letter, upper case Roman numeral, or lower case Roman numeral.

b.	In the Separator field, select the character that you want to appear after the number: period [.], close parenthesis[ ) ], or colon [:].

c.	Repeat steps a. and b. for level 2 and level 3.

7.	In the Starting At field, use the up and down arrows to select the number at which you want to start numbering the list.  If you are using letters to identify your list, ForeHelp translates the starting number to the appropriate letter according to its position in the alphabet.

8.	Select a paragraph style option:

No Indent	Retains the paragraph style.  The first line starts at the first tab position of the paragraph.

Hanging Indent	Sets the first line indent at the left edge of the window and sets the left margin at .25 inch.  Any other style definitions of the selected paragraph remain the same.

Use List Style	Applies the List1 style to the leftmost paragraphs, List2 style to the next indented paragraphs, and List3 style to the rightmost paragraphs.

9.	Choose the OK button.  ForeHelp inserts number(s) before each selected paragraph.

Bullet and Numbering Dialog Box: Multi-Level Option

Click on the parts of the box below where [image] appears for explanations of features.


Numbering Single Level Lists

This topic contains the following sections:

To Insert Numbers in Single Level Lists

To Repeat Number Insertion

To Delete Numbers

To Renumber or Modify Numbered Lists

Bullet and Numbering Dialog Box: Single Level Option

ForeHelp can automatically number paragraphs to produce ordered lists, procedure steps, and three-level outlines.  You can identify paragraphs with numbers, upper or lower case letters, and upper or lower case Roman numerals.

Paragraphs within a single level list all have the same margins and are not indented underneath another step.  To number lists with sublists, such as outlines, see Numbering Multiple Level Lists.

To Insert Numbers in Single Level Lists

1.	Place the text cursor in the paragraph at which you want to insert a number or select the paragraph(s) that comprise your numbered list.

2.	Choose the Text|Insert Bullets command to access the Bullet And Numbering dialog box.

3.	Check the Single Level option.  The dialog box changes to display three fields: Level 1, Starting At, and Separator.

4.	In the Level 1 drop-down list box, select the type of number that you want to use: number, upper case letter, lower case letter, upper case Roman numeral, or lower case Roman numeral.

5.	In the Starting At field, use the up and down arrows to select the number at which you want to start numbering the list.  If you are using letters to identify your list, ForeHelp translates the starting number to the appropriate letter according to its position in the alphabet.

6.	In the Separator field, select the character that you want to appear after the number: period [.], close parenthesis [ ) ], or colon [:].

7.	Select a paragraph style option:

No Indent	Retains the paragraph style.  The first line starts at the first tab position of the paragraph.

Hanging Indent	Sets the first line indent at the left edge of the window and sets the left margin at .25 inch.  Any other style definitions of the selected paragraph remain the same.

Use List Style	Applies the List1 style to the selected paragraph.  The List1 style is a hanging indent style based on the Base style.  The first line indent is set at the left edge of the window and the left margin is set at .25 inch.

8.	Choose the OK button.  ForeHelp inserts number(s) before each selected paragraph.

To Repeat Number Insertion

ForeHelp remembers the last bullet or number that you inserted using the Bullet And Numbering dialog box.  You can insert another number, or list of numbers, without accessing this dialog box.

1.	Insert one or more numbers following the steps in To Insert Numbers in Single-Level Lists.

2.	Select the paragraph(s) where you want to insert another numbered list.

3.	Click on the [image] toolbar button.  ForeHelp inserts numbers starting at 1.  It uses the style and type of number that you selected the last time you accessed the Bullet And Numbering dialog box.

Warning: When you use this button, ForeHelp inserts the last bullet or number selection that you made in the Bullet And Numbering dialog box.

To Delete Numbers

1.	Select the number.

2.	Press the [image] key.

To Renumber or Modify Numbered Lists

You can manually renumber lists by deleting the number and typing in a new number.  You can also have ForeHelp automatically renumber the lists for you.  If you have inserted steps within the original list, you can have ForeHelp number the new steps and renumber the subsequent steps in the list.

1.	Select the paragraph(s) that you want to renumber.

2.	Choose the Text|Insert Bullets command to access the Bullet And Numbering dialog box.

3.	Select the starting number if needed.

4.	Select the number type and separator.

5.	Choose the OK button.  ForeHelp adds numbers to any previously unnumbered paragraphs and replaces the existing number(s) with new numbers.

Bullet and Numbering Dialog Box: Single Level Option

Click on the parts of the box below where [image] appears for explanations of features.


Opening a Backup File

This topic contains the following sections:

To Restore a Backup File

Expand Project Backup Dialog Box

Opening a backup file restores a project's database files, graphic files, and/or baggage files from the backup file.  Typically, you open a backup file if you have deleted the original files, if you want to use an earlier version of the project files, if you have moved the project to a different computer, or if the current project files have been corrupted.

You can choose to exclude some files from being restored, either before or during the restoration process.

To Restore a Backup File

1.	Choose the File|New/Open command, press [image] [image], or click on the [image] toolbar button to access the New/Open/Open As Template dialog box.

2.	In the Drive and Directory fields, select the location of the backup file.

3.	In the List Files of Type field, select ForeHelp Backup File.
ForeHelp displays the names of all backup files (with extension .FHB) found in this directory in the File Name list box.

4.	In the File Name list box, select the backup file name.

5.	Choose the OK button.
The Expand Project Backup dialog box appears.  The Archive Contents box lists all files contained in this backup file.  By default, all files are selected to be restored.

6.	If you do not want to restore all of the files in the backup file, deselect any unneeded files from the list in the Archive Contents box.  If you deselect a file with the extension .DB*, all *.DB* files are deselected because these files work together.

To exclude all graphic files from the list, clear the Include Graphic Files check box.
To exclude all baggage files from the list, clear the Include Baggage Files check box.

7.	To restore the database using a different name than its original name, enter a new name in the Database Name field.

8.	Select the destination drive and directory where you want the project to be placed.  To create a new subdirectory within the selected destination directory, choose the Create Dir. button.  The Create Directory dialog box appears.  Enter the name of the new directory and choose the OK button.
ForeHelp creates a new directory within the destination directory.

9.	Choose the OK button.

ForeHelp restores the project to the designated location.  If ForeHelp finds a file of the same name in the same location, it displays a message asking if you want to replace the existing file with the file being restored.

Expand Project Backup Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Opening a Damaged File
Opening a Damaged Help Project

This topic contains the following sections:

ForeHelp Recovery Message

To Open the Copy Containing Your Latest Revisions

To Open the Last Saved Version

If you selected the Edit copy check box when you opened the help file in the New/Open/Open As Template dialog box, ForeHelp creates a temporary copy of the help database.  When you close the database normally, ForeHelp overwrites the original database file with the temporary copy containing your latest edits.

If you experience a crash, the File Name list box in the New/Open/Open As Template dialog box contains your original file name and the name of the temporary copy as FHXXXXXX.DBA (where XXXXXX is a randomly generated number.)  The numbered file contains the latest changes made before the crash.  The original file name contains the file as it was when you last saved it during the last editing session.

When you reopen ForeHelp, the following dialog box displays:

Click on the parts of the box below where [image] appears for explanations of features.

To Open the Copy Containing Your Latest Revisions

1.	Choose Recover.
ForeHelp attempts to recover the temporary copy of the database, while saving your original database.  If the temporary copy is valid, ForeHelp renames it as your original database.  If the temporary copy is corrupt, ForeHelp prompts you to open your original database.

To Open the Last Saved Version

1.	Choose Revert.
The temporary copy of the database that crashed is deleted.  Your original database opens.  Any edits made since the last time you saved the project during the last editing session are lost.


Opening an Existing Help Project

This topic contains the following sections:

To Open an Existing ForeHelp Database (.DBA file)

To Open a Help Project (.HPJ file)

You can use ForeHelp to open existing ForeHelp database files, backup files created with ForeHelp, and help project (.HPJ) files created with ForeHelp or with another authoring product.  You can also use ForeHelp to construct a help database using the .RTF file from a help project.  (See Recreating a Help File from an .RTF File.)  To open a backup project, see Opening a Backup File

To Open an Existing ForeHelp Database (DBA file)

1.	Choose the File|New/Open command, press [image] [image], or click on the [image] toolbar button to access the New/Open/Open As Template dialog box.
The List Files of Type is automatically set to ForeHelp Database.

2.	Select the appropriate Drive, Directory, and File Name of the .DBA file desired.

3.	Choose the OK button.
ForeHelp opens the selected database.  If the database was created with an earlier version of ForeHelp, ForeHelp displays a message indicating that it must convert the database first.  This can take a long time for a large database.

To Open a Help Project (HPJ file)

ForeHelp can create a ForeHelp database using a help project file (.HPJ) created by ForeHelp or by any other help authoring tool.  The .HPJ file contains references to the .RTF file(s), file paths and picture paths, and other information needed to reconstruct an entire help project.  The .RTF file(s) and picture files should be in their original locations in order for the project to be reconstructed with the best results.

1.	Choose the File|New/Open command, press [image] [image], or click on the [image] toolbar button to access the New/Open/Open As Template dialog box.

2.	In the List Files of Type drop-down list, select Help Project.
ForeHelp displays all files with the .HPJ extension in the File Name list.

3.	Select the appropriate Drive, Directory, and File Name of the .HPJ file desired.

4.	Choose the OK button.
ForeHelp recreates the database and displays the Import Status window.


Order Form

ForeFront Order Form

5171 Eldorado Springs Drive, Boulder, CO  80303

Phone: (800) 357-8507 or (303) 499-9181       FAX: (303) 494-5446

Ship To	Bill To

Name	_______________________________	Name	___________________________________

Title	_______________________________	Title	___________________________________

Company	_______________________________	Company	___________________________________

Address	_______________________________	Address	___________________________________

_______________________________	___________________________________

City/State/Zip	_______________________________	City/State/Zip	___________________________________

Phone	_______________________________	Phone	___________________________________

FAX	_______________________________ 	FAX	___________________________________

Where Did You Hear About These Products?	________________________________________________________

Product	Note	Quantity	Unit Price	Total
ForeHelp 2.0			$395*
ForeHelp 2.0 Upgrade	Provide s/n or fax proof of purchase by 10/1/95		$89
Help Browser for ForeHelp	ForeHelp Developer's License		$129*
ForeFront Help Buttons			$69*
ForeHelp Extended Support  Policy	One year ForeHelp telephone support plus  free ForeHelp upgrades during that year		$120*
OCC Help Browser	Single User, non-ForeHelp		$89*
OCC Help Browser	Site License to 2,000 Users, non-ForeHelp		$759
OCC Help Browser	Developer's License, non-ForeHelp		$399*
Colorado residents add 3% sales tax
Boulder County residents also add 1.15% sales tax
Shipping and Handling**
Total
*	Call about our quantity pricing and ForeHelp Competitive Upgrades

**	48 States	Priority mail $5 ea. item; Airborne $15 first item, $2 each add'l item; UPS Ground $7 first item, $2 each add'l item, UPS COD Add $5

Alaska, Hawaii	Priority mail $5 ea. item; Airborne $45 first item, $5 each add'l item; UPS Second Day $15 first item, $3 each add'l item, UPS COD Add $5

Canada	Airmail $10 ea. item; Airborne $45 first item, $5 each add'l item; UPS Ground $15, $3 each add'l item, no COD

International	Airmail $30. ea item; Airborne $57 first item, $5 each add'l item; no COD

Method of Payment

r	Visa	Full Name on Card	____________________________	r	Check (prepaid w/ US funds drawn on US bank)

r	MasterCard	Card Number	____________________________	r	Purchase Order #    ___________________

r	Amex	Expiration Date	____________________________	Sorry we can only accept domestic POs, Net 30

Signature	____________________________	Please include/fax copy of PO with your order


Order Form: Developer's License
Help Browser Developer's License, non-ForeHelp

This license provides non-ForeHelp help authors with the Help Browser development product.  It enables them to create a Help Browser database and to ship the database and the runtime Browser DLL with their own .HLP files.


Order Form: Site License
Help Browser Site License

This license allows up to 2,000 help file users to use Help Browser.  Users can add the Browse and Find Text functionality to any .HLP file viewed on their PCs.  This license is not required for .HLP files built with Help Browser.


OrderForm: Help Browser
ForeHelp Developer's License

This license provides you with the Help Browser add-on product.  It allows you, as a ForeHelp developer, to create a Help Browser database and to ship the database and the runtime Browser DLL with your .HLP file.  The Help Browser gives your end reader two additional buttons on the WinHelp button bar: Browse and Find Text.  Through the use of these buttons, your readers can print any and all topics, perform a text string search throughout the entire help file, and display a Browser window, which they can collapse and expand to view and navigate through the help file hierarchy of topics.  See Help Browser.


OrderForm: Single User
Help Browser Single User License

As a help file user, you can turn on Help Browser to add the Browse and Find Text functionality to any .HLP file you view on your PC.


Organizing Macros into Sets

This topic contains the following sections:

To Organize Macros into Sets

To Add a Macro Set to Your Project, Topic, or Hotspot

To Remove a Macro Set

Macro Sets Dialog Box

If you need to assign the same macros in several different locations within your project, you can organize these macros into sets.  ForeHelp places the name of the set into the list of available macros.  You can then add all of the macros in the set to your project, a topic, or a hotspot by selecting the set name.

You cannot add a macro set defined in one project to another project.  You can define macro sets within projects that you use as templates.

Each time you add a macro set to your project, a topic, or a hotspot, ForeHelp treats the macros as if you added each command separately.  You can include macros in the set that use a different parameter value for each occurrence.  After adding the set, you can edit the macro whose parameter must change.

If you want to remove or edit a macro from all occurrences, you must make the modifications at each place where you added the macro.

To Organize Macros into Sets

1.	Access any macro dialog box.  See Accessing Macro Dialog Boxes.

2.	Add the macros that you want in one set.  See Adding Macros.

3.	Choose the Make Set button to access the Macro Sets dialog box.

4.	In the Macro Sets field, enter a new name for the set.  If you previously made macro sets, you can select an existing name from the drop-down list box to replace the contents of its set.

5.	Choose the OK button to return to the macro dialog box.
ForeHelp adds the name of the set to the available macro list in the Command List drop-down list box.

6.	Continue to define other macros or choose the OK button.

To Add a Macro Set to Your Project, Topic, or Hotspot

1.	Access the appropriate macro dialog box.  See Accessing Macro Dialog Boxes.

2.	In the Command List field, select the name of the set you want to assign.

3.	Choose the Add button.
All of the macro commands within this set display in the Current Macro Commands list.

4.	Choose the OK button.

To Remove a Macro Set

You can remove a macro set from the Command List.  However, if you have assigned the macro set anywhere in your project, you cannot automatically unassign the macros included in the set.  You must remove each macro separately.  See Removing Macros.

1.	Access any macro dialog box.  See Accessing Macro Dialog Boxes.

2.	Choose the Make Set button to access the Macro Sets dialog box.

3.	In the Macro Sets drop-down list box, select the name of the set you want to remove.

4.	Choose the Remove button.
ForeHelp deletes the name of the set and closes this dialog box.  ForeHelp retains any macros throughout your project that you added using this set name.

5.	Choose the OK or Cancel button to close the macro dialog box.

Macro Sets Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Page Setup Dialog Box

Choose File|Page Setup or the [image] button in the Reporter or Grapher toolbar to access the Page Setup dialog box.  You can change headers, footers, justification, and margins for printing reports from Grapher or Reporter.

Click on the parts of the box below where [image] appears for explanations of features.


Paragraph

A paragraph is the text between one hard return and the next.  You insert a hard return by pressing the [image] key.  Hard returns are designated by a paragraph symbol ( [image]), which can be seen when text detail is turned on in the Preferences dialog box.  Styles and Paragraph Formats affect a whole paragraph at a time.  To format a portion of a paragraph, select the text and use the Character Format dialog box.


Paragraph Format Dialog Box

Important:  Changes made to selected paragraphs using the ruler or the Paragraph Format dialog box override style settings of the same options.  To reverse any such local changes when applying a style, select the text and press [image] [image], or click on the [image] toolbar button.  See Applying Styles.

To access the Format Paragraph dialog box, choose the Format|Paragraph command, press [image] [image], or click on the [image] toolbar button.

Click on the parts of the box below where [image] appears for explanations of features.


Paragraphs

You can position and format text in the window by adjusting whole paragraphs at a time.  You can change tabs, indents, margins, and line spacing, as well as applying styles that change the fonts.  Some things to know are:

ForeHelp and WinHelp automatically adjust the paragraph size according to its current window size.  The margin settings refer to the distance from the left and right edges of the window size.  As you set margins and tabs, test your project with different window sizes to verify that the appearance of your text is appropriate for the way a reader might view it.

A paragraph is the area between hard returns represented by the paragraph symbol ( [image]).  You create a new paragraph by pressing [image].  (The paragraph symbol is visible when you turn on text detail in the Preferences dialog box.)  ForeHelp automatically wraps words from one line to the next within a paragraph.

You can create a new line by pressing [image] [image] or choosing the Text|Line Break command.  A new line is represented by the line-break symbol ( [image]) when text detail is turned on.  This new line is part of the existing paragraph and does not start a new paragraph.  The beginning text of the new line will always start a new line, regardless of the size of the window.  If the text on the new line is longer than the size of the window, the overflow text wraps to successive lines.

New paragraphs take the format of the previous paragraph when you are entering new text.

To change formats of existing paragraphs, place the text cursor in one paragraph to select only this paragraph, highlight several contiguous paragraphs, or choose the Edit|Select All command to select every paragraph in the current topic.


Paste Definition
Paste

To copy the data from the Clipboard into the topic at the cursor location, choose the Edit|Paste command, press [image] [image], or click on the [image] toolbar button.


Paste Special

This topic contains the following sections:

To Prepare a Document for Paste Special

To Use the Edit|Paste Special Command

Paste Special Dialog Box

Windows applications that support .RTF format use this format when you cut or copy text to the Clipboard.  When the Clipboard contains .RTF format, the Edit|Paste Special command and the [image] toolbar button are available.  This command enables you to create new, separate topics from the copied text when that text contains hard page breaks.  If you keep the text as a single topic, ForeHelp places it at the cursor location in the current topic and does not paste in any text following the hard page break.

This command also lets you control how ForeHelp handles styles in the .RTF text that have the same name as the styles in your ForeHelp project:

Apply the style definitions from the ForeHelp project to the imported text (override the definitions in the imported text).

Apply the style definitions from the imported text to your ForeHelp project (override the existing definitions in the project).

Retain both style definitions.  ForeHelp appends a number to the imported style name (for example, Base-1).

In all cases, ForeHelp retains all unique style names whether they appear in the imported file or in the ForeHelp project.

To Prepare a Document for Paste Special

Use these instructions if you want to copy parts of another file into ForeHelp.  The file must be on the same computer as the ForeHelp project.

1.	Using the software package that created the file, open the file containing the text to be copied.

2.	If you want to create separate topics from the text that you are copying, insert hard page breaks to mark the end of one topic and the start of another topic.  Start each topic with the topic title.  ForeHelp automatically uses the first line of each topic as the topic title and context string.

3.	Select the text to be copied.

4.	Cut or copy the text from the document.  The software package places the selected text on the Clipboard.

To Use the Edit|Paste Special Command

1.	Open or create a ForeHelp project using the File|New/Open command.

2.	If you want to paste the entire contents of the Clipboard into a single topic, choose the Topic|Goto command to display the desired existing topic or choose the Topic|New command to create a new topic.  Position the cursor in the topic where you want the text to be pasted.

3.	Choose the Edit|Paste Special command, press [image] [image] [image], or click on the [image] toolbar button to access the Paste Special dialog box.

4.	To create separate topics, check the Create Topic at Page Break box.

5.	Choose one of the Common Named Styles options.

6.	Choose the Paste button.
If you do not specify Break Into Topics, ForeHelp inserts all text that precedes the first hard page break into the current topic at the cursor location.  It does not insert any text that follows the first hard page break.

If you specify Break Into Topics, ForeHelp pastes the .RTF text into new topics in your project.  The topic names correspond to the first line within each inserted page.  You can rename each topic by using the Topic|Properties command.

7.	Choose Topic|Goto, press [image] [image], or click the [image] toolbar button to view all topic names and to go to any topic.

Paste Special Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Picture

Pictures are graphics files that you can insert into ForeHelp.  Files can be Windows bitmap files (.BMP), Windows metafiles (.WMF), multi-resolution bitmap files (.MRB), and segmented hypergraphic files (.SHG).


Pictures

ForeHelp lets you insert pictures (graphics) into a topic's main text or banner.  You can:

Insert bitmaps (.BMP or .DIB files), metafiles (.WMF), multiple resolution bitmaps (.MRB), or segmented hypergraphic (.SHG) files.

Paste a graphic from the Clipboard (including "snapping" pictures of windows and dialog boxes using Windows' built-in screen capture feature).

Change position, delete, replace, or change storage method of graphics.

Rescale pictures.

Place hotspots on pictures allowing the reader to execute jumps, popups, or macros by clicking on them.

When you insert pictures in your project, the WinHelp compiler uses the path names of the graphic files to locate those files when you compile your final project.  It is beneficial to plan, in advance, to store the graphics you are using in a convenient place and not move them until your project is finished.  If you do move them, you must reinsert the files to establish new links.

You can instruct ForeHelp to place all graphics files into their own directory, in the same directory as the text files, or in the same directory as all other files created during the build process.  See Project Paths.


Popup

A popup is a hotspot that displays another topic in a small box on top of the current topic in the help window.  The box closes automatically with any keystroke or mouse click.  See Jumps and Popups.


Preferences
Preferences Dialog Box

ForeHelp enables you to set various system preferences that adjust the way in which ForeHelp looks and acts and the way in which WinHelp looks on your system.  The settings for WinHelp colors do not affect the display of colors on your reader's system.  WinHelp uses the settings in your reader's WIN.INI file to display hotspot text.

Choose the File|Preferences command to access the Preferences dialog box.

Click on the parts of the box below where [image] appears for explanations of features.


Print

ForeHelp lets you print the information in any or all of your topics, either to the printer directly or to a file for later printing.  ForeHelp automatically uses the Windows default printer defined in the Windows Control Panel, though you can select any Windows-supported printer that you have installed.  Once you make changes to the ForeHelp Print Setup dialog box directly, those changes stay in effect when printing ForeHelp topics even if you make changes in the Windows Control Panel.  You can also make changes to the printer setup for the current print job only.

To print reports from the Reporter, see Printing Reports.

To print output from the Grapher, see Printing Graphs.


Print Dialog Box

The Print dialog box appears whenever you choose the File|Print command or the [image] toolbar button in the Grapher window or the Reporter Window.  You can ensure that you are using the correct printer, select a print quality for this print job, and specify the number of copies.

To change the printer, page orientation, paper source or paper size for this print job, choose the Setup button.  To make these changes for all print jobs, choose the File|Print Setup command from ForeHelp's main window.

Click on the parts of the box below where [image] appears for explanations of features.


Printing Graphs

You can print any graph that displays in the Grapher window.  To generate a graph, see Grapher.  Graphs are best printed in portrait orientation.

To Print the Graph

1.	Click the [image] button on the Grapher toolbar, or choose the File|Print command from the Grapher's menu.
The Print dialog box appears.

2.	To change the printer name or to check and change the settings for page size, paper source, and orientation of the graph on the paper, choose the Setup button to access the Print Setup dialog box.  Any changes made in this Print Setup dialog box apply only to the current print job.  NOTE: To make permanent changes, choose the File|Print Setup command from ForeHelp's main menu.

3.	In the Print dialog box, select the print quality and the number of copies to be printed.

5.	Choose the OK button.
The graph prints.


Printing Reports

You can print any report that the Reporter displays in the Reporter window.  For instructions on creating the report, see Generating Reports.  If your report contains many fields for the selected topics, ForeHelp prints additional pages to accommodate the fields.  To minimize the number of pages generated, print the report in landscape orientation using a small font.  If your report contains only project lists and statistics, print the report in portrait orientation using a small font to minimize the number of pages.

To Print the Report

1.	Click the [image] button on the Reporter toolbar, or choose the File|Print command from the Reporter's menu.
The Print dialog box appears.

2.	To change the printer name or to check and change the settings for page size, paper source, and orientation of the report on the paper, choose the Setup button to access the Print Setup dialog box.  Any changes made in this Print Setup dialog box apply only to the current print job.  NOTE: To make permanent changes, choose the File|Print Setup command from ForeHelp's main menu.

3.	In the Print dialog box, select the print quality and the number of copies to be printed.

5.	Choose the OK button.
The report prints.


Printing Topics

This topic contains the following sections:

To Print Topics

Print Topics Dialog Box

You can print the text and graphics of the topics within your ForeHelp project using the File|Print Topics command.  You can print the topics directly to the printer or to a file for printing later.

You can also print topics by first generating a manual in ForeHelp then printing it using a word processor.  (See Generating Manuals.)

To Print Topics

1.	Choose the File|Print Topics command, or press [image] [image] [image] to access the Print Topics dialog box.  The current topic is highlighted in the Topics list box.

2.	In the Topics list box, select the topic(s) that you want to print.  Or choose the Select All button to print all of the topics.  You can click on any highlighted topic to remove it from the list of selected topics.

3.	Complete other options as needed, such as print quality or number of copies.

4.	If you want to print the topics to a file that you can print later, check the Print to File box.

5.	Choose the Setup button to change the printer, orientation of the topic on the page, page size, or paper source for this print job only.  (Use the File|Printer Setup command to change these items permanently.)

6.	Choose the OK button.  A status box appears while ForeHelp prepares each topic for printing.

Print Topics Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Programmer Provides Context Numbers

This topic contains the following sections:

To Assign the Corresponding Context Number to the Destination Help Topic

To Assign the Corresponding Context Number to an Alias

To Import a Context Map File

When the programmer provides you with context numbers for the dialog boxes, you need to assign the corresponding numbers to either the help topic or an alias, or you can import the programmer's context map file into your project.

To Assign the Corresponding Context Number to the Destination Help Topic

1.	Go to the destination topic.

2.	Choose the Topic|Properties command, press [image] [image], or click on the [image] toolbar button to access the Topic Properties dialog box.

3.	Enter the correct context number in the Context Number field.

4.	Choose the OK button.

5.	Repeat steps 1 through 4 for the remaining destination topics on the list.

To Assign the Corresponding Context Number to an Alias

Aliases are special targets that are associated with a topic or target but can later be reassigned to a different topic or target if topics are split, combined, or rearranged.  You can redirect the alias without changing context numbers in the code or help file.  See Project Aliases dialog box.

To Import a Context Map File

When you import a context map file provided by your programmer, ForeHelp attempts to match the context information in the file with the topics in your project, in the following manner:

If there is no match for a context number in the file, ForeHelp creates a disconnected target with a context number and context string based on the information in the #include context map file.  ForeHelp lists the disconnected targets in the Context String drop-down list boxes in the Topic Properties, Copy Topic, and Insert Target dialog boxes and in the Disconnected Targets drop-down list box in the Project Aliases dialog box, so that you can reconnect context strings to new or existing targets.  See Reconnecting Targets for instructions.

If the context string matches a topic but the number is already used in another topic, ForeHelp leaves the number blank for the matching context string.

If the context string matches a topic and the topic does not have a number assigned, ForeHelp assigns a number to the topic.

To change a context number from an imported file, have the programmer change the number in the #include context map file.  Then reimport it into ForeHelp.

1.	Choose the Project|Import Context Map File command to access the Import Context Map Files dialog box.  This is a standard Windows file open dialog box.  Note: You can also access this dialog box from within the Context Mapping dialog box by selecting the Import button.

2.	Select the location, file type, and name of the context map file.

3. 	Choose the OK button.
ForeHelp displays a status box with information about the replacements being made.


Project Aliases Dialog Box

An alias is a special kind of target that points to another target instead of a place within topic text.  An alias has a context string, optional context number and context map file.  When you implement context-sensitive help, you can have the external program call the alias instead of a topic target.  As you create and modify your help database, you can easily reassign the alias to the correct topic.  You can have dialog boxes with different context numbers call the same help topic by assigning several aliases to the topic.

You can also create a jump or popup to an alias that you are using as a placeholder for a topic.  When you create the topic, combine topics, or break topics into smaller topics, you can quickly redirect the jumps and popups to the correct topics.

You can assign an alias to only one topic at a time.  A topic can have multiple aliases assigned to it.

To access the Project Aliases dialog box, choose the Project|Aliases command.  For instructions about working with aliases, see Add/Assign/Redirect/Find Aliases and Change/Remove/Delete Aliases.

Click on the parts of the box below where [image] appears for explanations of features.


Project Browse Sequences Dialog Box

Use the Project Browse Sequences dialog box to add, remove, and reorder topics in a named browse sequence.  Choose the Project|Browse Sequences command, press [image] [image] [image] keys, or click on the [image] toolbar button to access the Project Browse Sequences dialog box.

Click on the parts of the box below where [image] appears for explanations of features.


Project Build Status Window

This topic contains the following sections:

To Locate and Correct Build Warnings and Errors

To Control Warning Messages

Project Build Status Window

When you select options in the Build dialog box, and press OK, the Project Build Status window appears.  The Project Build Status window displays starting and ending times for build and/or compile operations, as well as warnings and errors.  You can easily locate each warning and error displayed during the build process.

ForeHelp lets you choose the type of warning messages that it displays.  See To Control Warning Messages.

To Locate and Correct Build Warnings and Errors

1.	Double-click on a warning or error message appearing between the Start project build and Build complete messages.  Your cursor jumps to the corresponding topic and location in the ForeHelp window.

2.	Correct the error.

3.	Press [image] [image] to return to the Project Build Status window.

4.	Repeat steps 1 through 3 until you have located and corrected all errors or warning conditions.

To Control Warning Messages

1.	Choose the File|Preferences command to access the Preferences dialog box.

2.	In the Build Warnings section, select one of the following options:

Show All	Displays all warning and error messages.

Show None	Omits all warning messages and displays all error messages.

Show All But Character	Displays all error messages and all warning messages except those that pertain to illegal characters, such as curly quotes, em dash, and bullet.  These are characters that might not be available on your readers' PCs.

Build Status Window

Click on the parts of the box below where [image] appears for explanations of features.


Project Menu

Command	Keyboard	Toolbar	Description
Properties...			Modify project information such as title, copyright information, and associated icon via the Project Properties dialog box.
Paths...			Manage the directories in which ForeHelp places or looks for the .HPJ file, the text files, and the graphic files for your project.
Macros...			Create project macros that run when your .HLP file runs.
Browse Sequences			View, create, and change browse sequences via the Project Browse Sequences dialog box.
Window Classes...			Create secondary windows and set the window size, colors, and other properties via the Window Classes dialog box.
Context Mapping...			Add context numbers and map files and assign topic identifiers via the Context Mapping dialog box.
Import Context Map File			Adds context numbers from a map file created by the application programmer.
Auto-Generate Context Numbers			Adds context numbers to all topics within the file automatically.
Aliases...			Create and assign aliases as special targets to redirect jumps, popups, and context-sensitive help via the Project Aliases dialog box.
Baggage...			Includes external files for use with DLLs in the compiled help file.
Build...			Creates .RTF, .HPJ, and .HLP files as well as checking for errors via the Build Dialog Box.
Test...			Instantly view and use your project as if it were compiled to test links and proofread work.
WinHelp			Runs your compiled .HLP file by launching WinHelp.
Generate Manual...			Generates an .RTF file so you can produce a hardcopy manual from your help project.


Project Paths

This topic contains the following sections:

To Change Directories for a Project

Project Paths Dialog Box

The Project Paths dialog box lets you select or create directories where you want ForeHelp to place the files created during the build process.  The dialog box displays the name of the project directory.  ForeHelp places all files in this directory unless you specify otherwise.  You can specify a build directory, a text path, and a graphic path.  If you specify only the build directory, ForeHelp places all files in this directory.  If you specify the text path, .RTF files and graphic files are placed here and the other files are placed in the build directory or project directory.  If you specify a graphic path, the graphic files are placed in this path.

The Reporter can display and list the project paths for your project in the Statistics section of the report.

To Change Directories for a Project

1.	Choose the Project|Paths command to access the Project Paths dialog box.
This dialog box displays the name of the current project directory in the Project Directory field.

2.	Choose the Build Directory button to change or create the directory where ForeHelp places the .HPJ and .HLP files.  The default is the project directory.
ForeHelp displays the Build Directory dialog box.

3.	Choose the Text Path button to change or create the directory where ForeHelp places the .RTF file.  The default is the build directory.
ForeHelp displays the Text Path dialog box.  See Text Path and Graphics Path.

4.	Choose the Graphics Path button to change or create the directory where ForeHelp places the .SHG files, the .BMP files it created when you pasted in a graphic larger than 64K, and the .TMP files it created during build for scaled or cropped bitmaps.  The default is the text path.
ForeHelp displays the Graphics Path dialog box.  See Text Path and Graphics Path

5.	Select the OK button when done.

Project Paths Dialog Box

For an explanation of the buttons in this dialog box, see Build Directory Dialog Box and Text Path and Graphics Path.


Project Properties Dialog Box

The Project Properties dialog box appears when you create a new help project.  When you access this dialog box to view or modify project information by choosing the Project|Properties command or pressing [image] [image] [image].  Project Title is the only required field.

Click on the parts of the box below where [image] appears for explanations of features.


Putting Hotspots on Pictures

This topic contains the following sections and subsections:

To Create Hotspots on Pictures

To Create the Link for a Jump, Popup or Macro

To Move the Hotspot Box

To Size the Hotspot Box

To Edit a Picture Hotspot

To Order the Movement of Tabs Through Hotspots

Order Hotspots Dialog Box

See also Changing or Deleting Jumps and Popups.

After you insert a picture file or paste a graphic into your ForeHelp project, you can use ForeHelp's Sheg Editor to add hotspot(s) to the picture.  The reader can click on the hotspot area of the graphic (a picture, part of a picture, dialog box, etc.) to access a jump, popup or macro.  WinHelp enables the reader to use the [image] or [image] key to move through hotspots on a picture.  ForeHelp enables you to select the order in which these keys access the hotspots.

When you exit the Sheg Editor, ForeHelp creates a .SHG file for this picture with its original file name.  If you had pasted the graphic and the graphic was less than 64 Kbytes in size, ForeHelp names the file FH######.SHG (where ###### is a randomly generated number).

To Create Hotspots on Pictures

1.	Enter the Sheg Editor by double-clicking on the picture.
A box appears around your graphic and the mouse pointer turns into an arrow.

2.	To select the area on the graphic for the hotspot, click and drag the arrow cursor to draw a box around the desired area.
The box appears with handles when it is selected.  When you click the cursor outside the box but within the graphic, the handles disappear and the box remains.  You must select the box (handles are visible) before you can move, size, or create a jump or popup, or add a macro to this hotspot.

To create the link for a jump, popup or macro:

a)	Select the hotspot box on the graphic (handles are visible).

b)	Click on the Jump, Popup, or Macro toolbar button, or choose the Text|Make Jump, Make Popup, or Make Macro command.
ForeHelp displays the appropriate dialog box.

c)	Check the Hidden box so the hotspot boxes do not show.  See Jumps and Popups.

To move the hotspot box:

a)	Select the hotspot box on the graphic (handles are visible).

b)	Click and hold the mouse button inside the box.
A hand cursor appears.

c)	Drag the box to the desired location.

To size the hotspot box:

a)	Select the hotspot box on the graphic (handles are visible).

b)	Click and drag one of the handles in the desired direction until the correct size is reached.

3.	Repeat step 2 to define as many hotspots as needed.

4.	Click outside the picture to exit the Sheg Editor.
ForeHelp displays the Save SHG File dialog box with the File Name field filled in with either the original name of the inserted file or a temporary name FH######.SHG (where ###### is a random number.  ForeHelp uses the temporary name when you paste in a picture, or when your help project contains multiple copies of a picture and you put hotspots on only one copy of the picture.

5.	Rename the file or choose a different drive or directory, if desired.

6.	Choose the OK button.
If you choose the Cancel button, all changes that you just made to the picture during the most recent Sheg Editor session are lost.

To Edit a Picture Hotspot

1.	Double-click on the graphic to enter the Sheg Editor.  If this .SHG file is used elsewhere in the project, ForeHelp displays a message asking if you want to modify all occurrences of the file or just this one.

2.	Click on the hotspot.

Size or move the hotspot as described in step 2 of To Create Hotspots on Pictures.

Press [image] to delete the hotspot.

3.	Click outside the picture to exit the Sheg Editor.  ForeHelp displays the Save SHG File dialog box.

4.	Rename the file or choose a different drive or directory, if desired.

5.	Choose the OK button.
If you choose the Cancel button, all changes that you just made to the picture during the most recent Sheg Editor session are lost.

To Order the Movement of Tabs Through Hotspots

1.	Double-click on the graphic to enter the Sheg Editor.

2.	Double-click the left mouse button anywhere in the graphic to access the Order Hotspots dialog box.
This dialog box lists all of the context strings for the hotspots on this graphic in the order that the [image] or [image] key currently moves through them.

3.	Select a context string.

4.	Choose the Up or Down button to reposition the context string in the list.

5.	Repeat steps 3 and 4 until the list is in the correct order.

6.	Choose the OK button.

7.	Click outside the graphic to exit the Sheg Editor.  If you have already saved this picture as an .SHG file, ForeHelp does not display the Save SHG File dialog box.

Order Hotspots Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


RTF_TOPIC_796436400


Reconnecting Targets

If you delete a target or topic that is the destination of a hotspot, ForeHelp stores the context string of the deleted target.  You can then reassign the context string to another target or topic.  ForeHelp automatically updates the links from the hotspots to the new target.  If you use the disconnected context string as an alias, you can reconnect a hotspot to an existing topic or target without replacing the target's context string.

There are three ways to reconnect hotspots to targets:

To reconnect a hotspot to a topic's default target

To reconnect a hotspot to a target within a topic

To reconnect a target as an alias

To Reconnect a Hotspot to a Topic's Default Target

1.	Create a new topic.  See Creating New Topics.

2.	In the Topic Properties dialog box, click on the down arrow on the Context String field.
ForeHelp displays a list of the disconnected context strings, from previously deleted targets.

3.	Select the context string that is connected to the appropriate hotspots.

4.	Complete the rest of the dialog box as needed for your new topic.  When you select the OK button, ForeHelp reconnects all the hotspots that were connected to this context string to the new topic.

To Reconnect a Hotspot to a Target within a Topic

1.	Create a new target.  See Creating Targets.

2.	In the Insert Target dialog box, click on the down arrow on the Context String field.
ForeHelp displays a list of the disconnected context strings, from previously deleted targets.

3.	Select the context string that is connected to the appropriate hotspots.

4.	Choose the OK button.
ForeHelp reconnects all the hotspots that were connected to this context string to the new target.

To Reconnect a Target as an Alias

Follow these steps to connect a disconnected target to an existing target or topic without changing the target's context string.

1.	Choose the Project|Alias command.  The Project Alias dialog box appears.

2.	From the Disconnected Targets drop-down list box, select the context string that you want to reconnect.  This context string appears in the All Aliases text box.

3.	From the Target drop-down list box, select the target or topic that you want as the destination of the hotspots associated with the disconnected context string.

4.	Select the Add button.  The Edit Alias dialog box appears.

5.	Assign a context number or context map file if needed.

6.	Select the OK button.  The context string now appears in the All Aliases list box and in the Aliases list for this target.


Recreating a Help File from an .RTF File

You can use ForeHelp to recreate a help file from its .RTF file.  ForeHelp interprets and reestablishes the topics and topic titles, context strings, jumps, popups, targets, macros, and keywords as in the original help file.  It also retains embedded windows and graphics, but does not interpret them.

To Recreate a Help Format File

1.	Follow the steps in Inserting Rich Text Format (.RTF) Files until step 8.

2.	In the General Options section of the RTF Import Options dialog box, check the Interpret As Help Format File option.  The Create Topic As Page Break option is automatically checked and the Create New Topic options in the Style Options section become unavailable.

3.	To replace all of the topics in the current project with the inserted topics, check the Replace Existing Topics options.

4.	You do not need to check the Map Bullets and Create Keywords From Index Entries options, because ForeHelp recreates bullets and keywords from a help file automatically.

5.	Choose the OK button.  ForeHelp recreates the help file and displays the Import Status window.


Removing Macros

Before you can delete a macro from your project, topic, or hotspot, you must access the appropriate macro dialog box (See Accessing Macro Dialog Boxes).

To Remove One Macro

1.	In the Current Macro Commands list, select the macro to be removed.

2.	Choose the Remove button.

To Remove All Macros

Choose the Remove All button.


Replacing .SHG Files

You can replace a picture that has hotspots on it (an .SHG file) with a new picture, without having to recreate the hotspots.  This works best if the picture is similar to the original .SHG file and has hotspots in similar locations, although you can easily adjust the hotspots to fit the new picture.

To Replace an .SHG File with a New Picture

1.	In your ForeHelp project, click on the picture that is an .SHG file.

2.	Choose the Text|Edit Picture command or click on the [image] toolbar button to access the Edit Picture dialog box (which is the same as the Insert Picture dialog box).

3.	In the List Files of Type field, select the file type of the new picture.

4.	In the Drives and Directories fields, select the location of the new picture.

5.	In the File Name field, select the name of the new picture file.

6.	Choose the OK button.
ForeHelp displays a message asking if you want to replace only the picture and keep the hotspots.

7.	Choose Yes.
ForeHelp displays the Save .SHG File dialog box.

8.	In the File Name field, enter the name for the new .SHG file or accept the default name.  You cannot name the file the same name as the .SHG file you are replacing.

9.	Choose the OK button.
ForeHelp removes the original picture and inserts the new picture.

10.	Double-click on the new picture to activate the Sheg Editor and adjust the hotspots as needed.  If the pictures are very different in size, the hotspots might not be visible.  Use the [image] key to locate them and then drag them to the appropriate size and location.


Reporter

The Reporter generates information about the topics within your project and about the project itself.  A report can include four sections of information:

List of your selected topic titles with any of 13 fields of information, such as number of hotspots and their destinations, keywords, browse sequences, context information, and RTF file association

List of all keywords in this project and/or the titles of topics where each keyword appears

List of all RTF files used in this project and/or the topics associated with each file

Selected statistics about the project, such as project title, number of topics and keywords, lists of browse sequences and project macros, directory information, and file sizes

The Reporter initially displays the selected information in the Reporter Window.  You can print the report from this window.


Reporter Definition
Reporter

The Reporter is a ForeHelp tool that allows you to create reports about your project.  Access the Reporter by choosing the Tools|Reporter command or clicking on the [image] toolbar button.


Reporter Options Dialog Box

Choose the Tools|Reporter command or click on the [image] toolbar button to access the Reporter Options dialog box.  When you select the options and choose the OK button, ForeHelp displays the report in the Reporter window.

Click on the parts of the box below where [image] appears for explanations of features.


Reporter Window

After selecting the topics and fields in the Reporter Options dialog box, the resulting report displays in the Reporter window.  Your selected field titles display with the selected topics' data listed in columns.  To print reports from this window, see Printing Reports.

Click on the parts of the box below where [image] appears for explanations of features.


Right Margin

The right margin of a paragraph is the distance from the right edge of the window to the right edge of the text, regardless of window size.  If you set the right margin at .5 inch away from the right edge, the right margin of that paragraph is always .5 inch from the right edge of the ForeHelp or WinHelp window whether the window is 2 inches or 6 inches wide.


Ruler

ForeHelp Window

The word processor ruler displays tab, margin, and indent settings in a ribbon below the toolbar.  You can modify these settings using the ruler, the Format|Paragraph command, or [image] toolbar button.  You can turn the ruler display on and off by accessing Preferences.  See Using the Ruler.


Save SHG File Dialog Box

The Save SHG File dialog box appears when you exit the Sheg Editor after you have placed at least one hotspot on the graphic.  If you enter and then exit the Sheg Editor without creating a hotspot, ForeHelp does not convert the graphic to an .SHG file.  Use this dialog box to name the .SHG file and to choose its location.

Click on the parts of the box below where [image] appears for explanations of features.


Saving Your Project

This topic contains the following sections:

To Save Your Project

To Delete the Current Modifications

ForeHelp, by default, makes a temporary copy of your database when you open it.  As you modify the database, ForeHelp modifies the copy and not the original.  When you close the database normally, ForeHelp overwrites the original database with the modified copy.  You can also save your changes to the original file while you have the database open.

If you are using ForeHelp with a temporary database, ForeHelp lets you cancel all modifications made in the current editing session from the time you opened the database or from the time you last saved it (whichever is most recent).  These are the changes that ForeHelp has not yet written to the original database.

Note:	If You clear the Edit Copy check box in the New/Open/Open As Template dialog box when you open your database, ForeHelp writes all modifications directly to the original database.  You cannot use the File|Revert Project command to restore an earlier version of the database.

To Save Your Project

1.	Choose the File|Save Project command, press [image] [image], or click on the [image] toolbar button.
ForeHelp updates the original file on the hard disk with any modifications since you opened the file or since you last saved the project.

To Delete the Current Modifications

1.	Choose the File|Revert Project command or click on the [image] toolbar button.
ForeHelp restores your currently open database to the state that it was in when you opened it or last saved it.  All changes are deleted.


Scaling and Cropping Pictures

This topic contains the following sections:

To Scale a Picture

To Crop a Picture

Within your ForeHelp project, you can scale the size of a picture (bitmap, metafile, or .SHG file) or crop a bitmap.  Scaling increases or decreases the elements of a graphic image proportionately.  Cropping cuts off a part of the graphic image and leaves the remaining elements at their original sizes.

Note: Due to the nature of bitmaps, a scaled bitmap has the same qualities provided by other graphics packages.

When you scale or crop a picture, ForeHelp displays a message that enables you to apply the scaling or cropping to all occurrences of the selected picture within the project or to only the selected picture itself.

If the scaled or cropped picture is a bitmap or metafile, ForeHelp creates a new picture file during the build process and names it FH######.TMP, where ###### is a randomly generated number.  If you scale a .SHG file, ForeHelp generates the file at the time you scale the picture and names the file FH######.SHG.  The original file name still appears in the database unless you open the project from the .HPJ file.

You can cut or copy and paste scaled and cropped pictures between ForeHelp and other applications (such as Microsoft Word) that retain the picture size information.

To Scale a Picture

1.	Place the cursor on an edge of the picture in the direction you want to enlarge or reduce its size.  To scale a picture both horizontally and vertically at the same time, place the cursor in a corner of the graphic.
The cursor becomes a double-arrow pointer.

2.	Click the double-arrow pointer and drag the sides of the picture until it is the desired size.

3.	To return the picture to its original size, choose the Edit|Undo Scale Picture command immediately after scaling the picture.

To Crop a Picture

1.	Place the cursor on an edge of the picture in the direction you want to enlarge or reduce its size.  To crop a picture both horizontally and vertically at the same time, place the cursor in a corner of the graphic.
The cursor becomes a double-arrow pointer.

2.	Press [image] and click the double-arrow pointer.

3.	Drag the sides of the picture until it is the desired size.

4.	To return the picture to its original size, choose the Edit|Undo Crop Picture command immediately after cropping the picture.


Search

Search is a WinHelp feature that lets you use keywords to locate specific information in a help file.  Access the Search dialog box by choosing Topic|Search, or [image] [image], or [image].


Search Dialog Box

To Access the Search Dialog Box

From the ForeHelp Window, choose the Topic|Search command, press [image] [image], or click on the [image] toolbar button.

From Test mode or from WinHelp, select the Search button.

Click on the parts of the box below where [image] appears for explanations of features.


Secondary Window

A secondary window is a window class that displays on top of the main WinHelp window.  Secondary windows contain no button bars or menu bars.  Secondary windows are ideal for displaying static information while the reader accesses other topics in the help file.  Examples of such information are glossary lists, reference lists, diagrams, table of contents, and examples.  See Window Classes.


See Also: ForeHelp Projects
ForeHelp Projects

Topics in Browse Sequence

ForeHelp Projects

Creating a New Help Project

New/Open/Open As Template Dialog Box

Project Properties Dialog Box

Topic Properties Dialog Box

Saving Your Project

Test Mode

Opening an Existing Help Project

Templates

Opening a Damaged Help Project

Other Related Topics

Creating New Topics

Backing Up a Project

Opening a Backup File

Understanding ForeHelp Project Files


See also:  ForeHelp Window
ForeHelp Window

ForeHelp Window

Using the Format Bar

Using the Ruler

Using the Status Line

Using the Toolbar

Customize Toolbar Dialog Box

Toolbar Buttons


See also: Alias
Aliases

Project Aliases Dialog Box

Add/Assign/Redirect/Find Aliases

Change/Remove/Delete Aliases

Edit Alias Dialog Box


See also: Backups
Backups

Backups

Backing Up a Project

Opening a Backup File


See also: Browse Sequences
Browse Sequences

Browse Sequences

Project Browse Sequences Dialog Box

Sequences Dialog Box

Creating and Modifying a Browse Sequence Name

Assigning and Viewing Topics in a Browse Sequence

Modifying and Deleting a Browse Sequence


See also: Build and Compile
Build and Compile

Build and Compile

Creating Rich Text Format (.RTF) Files

Project Paths

Build Directory Dialog Box

Text Path and Graphic Path

Create Directory Dialog Box

Project Build Status Window

Build Errors

Compiler Errors


See also: Context-Sensitive Help
Context-Sensitive Help

Context-Sensitive Help

Programmer Provides Context Numbers

Help Author Provides Context Numbers

Selecting a Context Map File

Exporting Context Map Files

Adding, Changing, Deleting Map Files

Context Mapping Dialog Box


See also: DLLs
DLLs

Embedded Windows

Creating/Editing/Deleting Embedded Windows

Baggage

Insert Special

256-Color Bitmap DLL


See also: Defining Color
Defining Color

Color Dialog Box

Creating Custom Colors


See also: Find and Replace
Find and Replace

Find and Replace

Using Find and Replace

Text Find Dialog Box

Find Operations

Finding and Selecting Text

Finding Text and Replacing with New Text

Finding Text and Making a Jump

Finding Text and Making a Popup

Finding Text and Making a Macro

Finding Text and Adding a Topic Macro

Finding Text and Adding a Keyword


See also: Grapher
Grapher

Grapher

Grapher Window

Printing Graphs


See also: Introduction
Introduction

What is ForeHelp

ForeHelp Help Conventions

ForeHelp Concepts & Terms

Understanding ForeHelp Project Files

Steps to Creating Your Help Project

Testing Your Project


See also: Jumps and Popups
Jumps and Popups

Jumps and Popups

Creating Jumps

Creating Interfile Jumps

Creating Interfile Popups

Creating Popups

Creating Hotspots and Topics Simultaneously

Changing or Deleting Jumps and Popups

Using Jumps and Popups


See also: Keyboard Shortcuts
Keyboard Shortcuts

Menu Command Keys

Cursor Movement/Selection Keys


See also: Keywords
Keywords

Keywords and Search

Adding Topic Keywords

Adding Text Keywords

Adding Keywords to the Master Keyword List

Changing Keywords

Deleting Keywords

Viewing Keywords

Using Search

Search Dialog Box

Finding Text and Adding a Keyword


See also: Lists
Lists

Bullets and Numbered Lists

Bullet and Number Examples

Inserting Bullets

Adding and Removing Bullet Pictures

Numbering Single Level Lists

Numbering Multiple Level Lists


See also: Macros
Macros

Macros

Accessing Macro Dialog Boxes

Adding Macros

Adding Nested Macros

Organizing Macros into Sets

Removing Macros

Editing Macros

WinHelp Macro Commands


See also: Manual Generation
Manual Generation

Manual Generation

Generating Manuals

Generate Manual Dialog Box


See also: Menus
Menus

Edit Menu

File Menu

Format Menu

Help Menu

Project Menu

Text Menu

Tools Menu

Topic Menu


See also: Navigator
Navigator

Navigator

Using Navigator

Navigator Window


See also: Paragraph
Paragraphs

Paragraphs

Paragraph Format Dialog Box

Setting Justification

Setting Paragraph Tabs

Setting Paragraph and Line Spacing

Setting Margins and Indentations

Creating Borders

Margin and Indent Samples


See also: Pictures
Pictures

Pictures

Inserting Pictures

Edit Picture Placement Dialog Box

Working with Pictures in Text

Copying and Pasting Pictures

Modifying and Deleting Pictures

Scaling and Cropping Pictures

Putting Hotspots on Pictures

Save SHG File Dialog Box

Replacing .SHG Files


See also: Print
Print

Print

Changing Print Setup for ForeHelp

Printing Topics

Printing Reports

Printing Graphs


See also: Reporter
Reporter

Reporter

Generating Reports

Reporter Options Dialog Box

Statistics Dialog Box

Reporter Window

Printing Reports


See also: Styles
Styles

Styles

Creating New Styles

Applying Styles

Editing Styles

Deleting Styles


See also: Tables
Tables

Tables

Creating a Table

Entering Text in a Table

Selecting Cells

Modifying a Table

Formatting a Table

Inserting and Deleting Rows and Columns

Deleting a Table


See also: Targets
Targets

Targets

Creating Targets

Deleting Targets

Editing Targets

Reconnecting Targets


See also: Text Editing
Text Editing

Text Editing

Entering a Banner

Entering Text

Moving through Text

Selecting and/or Deleting Text

Cut, Copy, Paste

Formatting Text

Character Format or Font Dialog Box

Changing Text Color

Using Special Characters


See also: Text from Other Files
Text -- Other Files

Text from Other Files

Features for Inserting Rich Text Format Files

Inserting Text (.TXT) Files

Inserting Rich Text Format (.RTF) Files

Recreating a Help File from an .RTF File

Inserting a Manual's .RTF File

Mapping Bullets

Cut, Copy and Paste

Paste Special


See also: Topics
Topics

Topics

Creating New Topics

Banners

Using Topics in Multiple Databases

Copying Topics

Deleting Topics

Changing Topic Properties

Moving among Topics


See also: Window Classes
Window Classes

Window Classes

Creating and Deleting Window Classes

Adding Captions to Windows

Controlling Window Size and Location

Changing Window and Banner Colors

Using Window Classes


Selecting Cells

There are several ways to select multiple cells:

Edit|Select Row selects the entire row containing the cursor.

Edit|Select Column selects the entire column containing the cursor.

Edit|Select Table or [image] [image] [image] selects all rows and columns of the table at the cursor location.

Drag the mouse pointer over a rectangular region, beginning at one corner.

Click in a cell, and hold [image], then click in another cell or press [image], [image], [image], or [image] to select all cells in between.


Selecting a Context Map File

This topic contains the following sections:

To Add or Create a Context Map File for the Project

To Select a Context Map File from the Project's List

ForeHelp lets you select or create a context map file in any dialog box where you can assign or change context strings or context numbers.  Examples of these dialog boxes are Topic Properties, Insert Target, Edit Target, and Edit Alias.  You can also select or create a context map file in the Context Mapping dialog box, in a slightly different manner than described here.  You can only delete a context map file or change its name using the Context Mapping dialog box.  See Adding, Changing, Deleting Context Map Files.

Each dialog box has a button marked Context Map File next to a drop-down list box.  The drop-down list box lists all of the context map files that you have used in this project.  The Context Map File button accesses a standard Windows file open dialog box where you can select or create another map file.

To Add or Create a Context Map File for the Project

These instructions assume that you have accessed a dialog box that contains a Context Map File button.

1.	Select the Context Map File button.  The Select or Create Context Map File dialog box, a standard Windows file open dialog box, displays.

2.	Select the appropriate drive and directory from the Drive and Directory lists.

3.	In the Files of Type list, select the type of file that you want ForeHelp to generate.  You can create a C or C++ file, a Visual Basic file, or a Pascal file.

4.	In the File Name field, select the file you want from the list or enter the name of a new file in the text box.

5.	Select the OK button.
The dialog box where you selected the Context Map File button is again active.  The name and path of the selected or created file appears in its Context Map File field.  Whenever you access a dialog box that has a Context Map File field, this file will appear in the list of map files for this project.

To Select a Context Map File from the Project's List

These instructions assume that you have accessed a dialog box that contains a Context Map File field.

1.	Click on the arrow on the Context Map File field to display the drop-down list of files available to the project.

2.	Select a map file.

3.	Choose the OK button when you have completed any other options in this dialog box.


Selecting and/or Deleting Text

This topic contains the following sections:

To Select Text
With the Mouse
With the Keyboard
With the Mouse and Keyboard
With Edit|Select All

Actions on Selected Text

Selecting refers to highlighting a range of text.  You can delete, format, cut, or copy selected text.

To Select Text

With the Mouse

Drag: Click and hold down the left mouse button until you have dragged the mouse across the text/graphics to be selected.  Click:  Click the left mouse button once to insert the cursor at the mouse-pointer position; click twice to select the current word; click three times to select the current sentence; and click four times to select the paragraph.

With the Keyboard

Hold the [image] key in combination with cursor movement keys (see Moving through Text).  Examples:   selects a word at a time; [image] [image] [image] selects the preceding paragraph(s).

With the Mouse and Keyboard

Hold the [image] in combination with clicking the mouse button.  All text between the beginning cursor location and mouse pointer is selected.

With Edit|Select All, or

If the cursor is in the main topic text, this option selects all text in the topic excluding the banner.  If the cursor is inside the banner, it selects all text inside the banner.

Actions on Selected Text

When you have selected text, you can perform the following options on the text:

Deletes characters, word(s), line(s), and paragraph(s).

Format|Character	Changes fonts, sizes, styles, and effects of text.
See Character Format dialog box.

Edit|Cut or 	Deletes the selected text and places it on the Clipboard.
See Cut, Copy, Paste.

Edit|Copy or 	Leaves the selected text as is and places a copy of the text on the Clipboard.
See Cut, Copy, Paste.

Edit|Paste or 	Replaces the selected text with the text on the Clipboard.

Text|Make Jump or 	Makes a jump from the selected text to a target.

Text|Make Popup or 	Makes a popup from the selected text to a target.

Text|Make Macro or 	Assigns a macro to the selected text that executes when the reader clicks on the text.

Text|Insert Target or 	Inserts a target at the left edge of the selected text and uses the selected text as the default context string.

Text|Insert Text Keyword	Associates the selected text with a keyword so that a Search operation using this keyword displays this line of text at the top of the WinHelp window.

Creates a keyword using the selected text, adds it to the master keyword list, and assigns the keyword to this topic.

Text|Insert Bullets	Creates a bulleted or numbered list of the selected paragraph(s).

Inserts another bullet or numbered item based on the last bullet or number selection.  If the last selection is a number, this button numbers the selected paragraphs starting at 1.


Setting Justification

Justification refers to the alignment of paragraph text, both wrapping text and new lines.  The ForeHelp default is left justification.  You can align text along the left margin, the right margin, or center it between the margins.

To Set Justification

1.	Choose the Format|Paragraph command, press [image] [image], or click on the [image] toolbar button to access the Paragraph Format dialog box.

2.	Click the down arrow to access the Justification drop-down list box.

3.	Choose one of the following options:

Left - The lines of the paragraph align along the left margin.  The right margin text is uneven or ragged.

Right - The lines of paragraph text align at the right margin.  The left margin alignment is uneven or ragged.

Center - All lines of paragraph text align around the center point between the left and right margins.  Both left and right margins are uneven.  This is a common alignment for titles and subtitles.


Setting Margins and Indentations

This topic contains the following sections:

To Set Margins and Indents Using the Ruler

To Set Margins and Indents Using the Paragraph Format Dialog Box

A margin is the amount of blank space between the edge of the ForeHelp or WinHelp window and the text.  When you set a left or right margin for a paragraph, the margin size remains the same when you or the reader resizes the window.

By changing the widths of the left margin, right margin, or the first-line indentation, you can achieve a variety of paragraph styles.  See Margin and Indent Samples.

To Set Margins and Indents Using the Ruler

For an explanation of the ruler icons or to display the ruler, see Using the Ruler.

Set the right margin by dragging the right margin icon ( [image]) to wherever you need it.

Set the left margin by dragging the bottom half of the icon ( [image]).  The top (first-line indent [image]) moves proportionally.

Set the first-line indent by dragging only the top half of the left margin icon to the right or left of the bottom half.

To adjust the left margin without moving the first-line indent, press the [image] key while dragging the bottom half of the icon.

To Set Margins and Indents Using the Paragraph Format Dialog Box

1.	Choose the Format|Paragraph command to access the Paragraph Format dialog box.

2.	In the Indents section, type in a measurement, or click in the appropriate field and click on the up or down arrows to select a measurement.  The measurements are in inches.

Set the left margin by entering a measurement in the From Left field.  If you enter a negative number, the left side of the paragraph does not display in the window.  The horizontal scroll bar does not access text that is beyond the left edge of the window.

Set the right margin by entering a measurement in the From Right field.  If you enter a negative number, the right side of the paragraph does not display in the window.  You must move the horizontal scroll bar to view the text that is beyond the right edge of the window.

Set the first-line indent by entering a measurement in the First Line field.  If you enter a positive number, the text of the first line starts to the right of the left margin (paragraph indent) .  If you enter a negative number, the text starts to the left of the left margin (hanging indent).  If you enter zero, the first line aligns with the succeeding lines of the paragraph (block-style paragraph).


Setting Paragraph Tabs

This topic contains the following sections:

To Set Tabs Using the Ruler

To Move Tab Settings Using the Ruler

To Set or Move Tabs Using the Paragraph Format Dialog Box

To Remove Tab Settings Using the Ruler

To Remove Tab Settings Using the Paragraph Format Dialog Box

ForeHelp provides default tab settings at every half-inch mark.  When you press the TAB key, the cursor moves 1/2 inch to the right and new text that you enter appears to the left of the tab setting.  If you have text detail turned on, you can see the tab marker within your paragraph.  When you display the ruler, the default tab icons appear on the ruler.  You can set optional tabs for any selected paragraphs.  The optional tabs override the default settings.

Important:  Changes made to selected paragraphs using the Ruler or the Paragraph Format dialog box override style settings of the same options.  To reverse any such local changes when applying a style, select the text and press [image] [image], or click on the [image] toolbar button.  See Applying Styles.

To Set Tabs Using the Ruler

NOTE: An optional tab removes all the default tabs between the optional tab and the left margin (or the previous optional tab).

1.	Select the paragraph(s) for which you want to set tabs, or just click in a single paragraph.

2.	Set one of the following tab styles:

To set a left-aligned tab ( [image]), click the mouse pointer on the ruler at the desired location.

To set a right-aligned tab ( [image]), press [image] and click on the ruler at the desired location.

To set a center aligned tab ( [image]), press [image] and click on the ruler at the desired location.

To Move Tab Settings Using the Ruler

1.	Select the paragraph(s) for which you want to modify the tab settings, or just click in a single paragraph.

2.	Move tabs by dragging them to the left or right.

To Set or Move Tabs Using the Paragraph Format Dialog Box

1.	Select the paragraph(s) for which you want to set or modify the tab settings, or just click in a single paragraph.

2.	Choose the Format|Paragraph command to access the Paragraph Format dialog box.

3.	In the Position field of the Tabs section, type the location of the tab in inches relative to the left edge of the screen.  You can use the incrementer (up arrow or down arrow) to adjust the location by .001 inch with each click on the arrow.  You can press the [image] key and click on the incrementer to adjust the location by .062 inch with each click.

4.	Select an alignment from the Alignment drop-down list box.  Left aligns tabbed text at the left side; Right aligns tabbed text at the right side; and Center aligns tabbed text around the center tab.

5.	Choose the New button.  The new tab setting is listed in the tab box.

To Remove Tab Settings Using the Ruler

1.	Select the paragraph(s) for which you want to remove the tab settings, or just click in a single paragraph.

2.	Click and hold the mouse button to drag the tab to be deleted up off the ruler. You cannot remove default tabs, except by placing optional tabs.

To Remove Tab Settings Using the Paragraph Format Dialog Box

1.	Select the paragraph(s) for which you want to remove the tab settings, or just click in a single paragraph.

2.	Select a tab setting in the tab list box.

3.	Choose the Delete button.  The tab setting is removed from the list box.


Setting Paragraph and Line Spacing

This topic contains the following sections:

To Set Space Before a Paragraph

To Set Space After a Paragraph

To Change Line Spacing

Paragraph spacing is the amount of blank space before the first line of the paragraph or after the last line of the paragraph.  You can separate block paragraphs by leaving blank lines between them.  Line spacing or leading is the amount of space allowed for each line within the paragraph.

The units of measurement for line and paragraph spacing are points (pt), lines (li), or inches (in).  You can enter a value in centimeters (cm).  If you use the up and down arrows to adjust the size after you enter a value in centimeters, ForeHelp displays the other values in terms of inches.

In ForeHelp, the default line height for one line is 12 points.  A half-line is equivalent to 6 points.

To Set Space Before a Paragraph

You can set space before a paragraph by creating blank paragraphs.  If you set the space using the Paragraph Format dialog box, you can adjust the amount of space as close as .001 inch.  You can also define styles that automatically include space before each paragraph.  This ForeHelp Help file uses .5 line (6 points) before each paragraph.

1.	Choose the Format|Paragraph command to access the Paragraph Format dialog box.

2.	In the Space section, enter the desired amount of space in the Before field.  You can also use the up and down arrows to select a value.

To Set Space After a Paragraph

You can set space after a paragraph by creating blank paragraphs.  If you set the space using the Paragraph Format dialog box, you can adjust the amount of space as close as .001 inch.  You can also define styles that automatically include space after each paragraph.

1.	Choose the Format|Paragraph command to access the Paragraph Format dialog box.

2.	In the Space section, enter the desired amount of space in the After field.  You can also use the up and down arrows to select a value.

To Change Line Spacing

The default for line spacing is automatic, in which ForeHelp adjusts the height of the line to allow space for the largest character or graphic on the line.  You can change this default to set a minimum height.  ForeHelp increases the line height if a graphic or character requires more room, but it does not decrease the height below your setting.  A third option is to set an exact height.  ForeHelp does not adjust the line height to accommodate graphics or text.

1.	Choose the Format|Paragraph command to access the Paragraph Format dialog box.

2.	In the Line Spacing field, click the down arrow to display the drop-down list box.

3.	Select one of the following options:

Automatic	Line spacing adjusts to allow for the largest character or graphic on the line.

At Least	Line spacing is not smaller than the size you specify, but it can be greater if a character or graphic requires it.  You must enter a nonzero value in the adjacent box, or the Line Spacing reverts to Automatic.

Exactly	Line spacing is exactly as specified regardless of character sizes or graphics.  You must enter a nonzero value in the adjacent box, or the Line Spacing reverts to Automatic.

4.	If you select At Least or Exactly, enter the measurement in the adjacent box in lines (li), points (pt), inches (in), or centimeters (cm).


Standard Windows File Open Dialog Box

This topic contains the following sections:

Dialog Boxes Using Windows File Open

Standard Windows File Open Dialog Box

ForeHelp uses a standard Windows file open dialog box for each situation where you must select or create a file for use in your ForeHelp project:

Dialog Boxes Using Windows File Open

Insert File	Choose .TXT or .RTF file to insert into your project.  See Text from Other Files.

Choose Icon	Insert an .ICO file to use as the icon for your project.  See Project Properties Dialog Box.

Select Main Dictionary	Choose an .NDX file to use as the main dictionary.  See Modifying a Dictionary.

Select User Dictionary	Choose or create an .SPL file with user-specific words.  See Modifying a Dictionary.

Select File	Select the appropriate file required by a macro command.  See Adding Macros.

Select Embedded Windows DLL	Select the dynamic link library (DLL) to insert in your project.  See Creating/Editing/Deleting Embedded Windows.

Add Baggage	Select the files required by a DLL to include with your final help file.  See Baggage and/or Insert Special.

Select or Create RTF File	Choose an existing file or create a new file in which ForeHelp will place the .RTF text from the Project|Generate Manual command.  See Generating Manuals.

Select or Create Context Map File	Choose an existing file or create a new map file in which ForeHelp places the #define statements for context-sensitive help.  See Selecting a Context Map File.

Import Context Map File	Select the name of the context map file that your programmers have provided for this help project.  See Programmer Provides Context Numbers.

Click on the parts of the box below where [image] appears for explanations of features.


Statistics Dialog Box

You access the Reporter's Statistics dialog box by first choosing the Tools|Reporter command or the [image] toolbar button and then choosing the Statistics button on the Reporter Options dialog box.

Click on the parts of the box below where [image] appears for explanations of features.


Status Line

ForeHelp Window

The area at the bottom of the ForeHelp window displays the name of the current topic and the line on which the cursor is placed.  If the cursor is on a hotspot, it shows the target to which the selected hotspot is connected or the macro associated with the macro hotspot.  If the cursor is on a picture, the status line displays the name of the file containing the picture.  If the cursor is on a target or text keyword, the status line shows the corresponding name.  The status line also displays temporary information and quick help, such as, menu option descriptions, dialog box field descriptions, RTF insert status, and backup information.


Status Line:Line Field
Line Field

Status Line of the ForeHelp Window

The Line field of the status line displays the line number location of the cursor within the current topic.


Status Line:Right Field
Right Field

Status Line of the ForeHelp Window

The unmarked field on the status line is blank until you position the cursor on a hotspot or click once on a graphic.  Then the field indicates the type of hotspot and the topic or macro associated with the hotspot.  For example, if the hotspot is a jump, the entry is Jumps To: topic name.  If the hotspot is a popup, the entry is Popup: topic name.  If the hotspot is associated with a macro command, the entry is Macro: command name.

If you click once on a graphic, the entry is Picture: graphic file name.


Status Line:Topic Field
Topic Field

Status Line of ForeHelp Window

The Topic field of the status line displays the name of the topic as you entered it in the Topic Name field of the Topic Properties dialog box.


Steps to Creating Your Help Project

These steps provide an overview of how to create a help project.  You must complete the Basic Project Creation Steps in the order shown.  You should complete the Project Management Steps periodically while you develop your project.  You complete the Enhancement Steps as needed to produce help files with specific features and capabilities.

Basic Project Creation Steps

Save your changes periodically throughout a editing session.  (See Saving Your Project.)

1.	Open ForeHelp and create a new project database file, or open another project, such as a ForeHelp example, to use as a template for a new database. (See ForeHelp Projects.)

2.	Create topics:  use ForeHelp’s word processing features to enter the text and graphics; or import or cut and paste text created in another word processor into the topics.  (See Topics and Text from Other Files.)

3.	Create connections between your topics to allow readers to access the topics, in one or more of the following ways:

a.	Create jumps from a location in one topic to another topic (such as from each entry of the table of contents to the appropriate topic).  (See Jumps and Popups.)

b.	Create popups from a location in one topic to another topic.    (See Jumps and Popups.)

c.	Create browse sequences and browse buttons to connect a series of topics.   (See Browse Sequences.)

d.	Add keywords to your topics to enable the reader to use WinHelp's Search feature.  (See Keywords and Search.)

4.	Test your project to ensure that your connections work the way you intended or to check that you final help file looks the way you want.  (See Test Mode.)

5.	Build and compile the final .HLP file.  (See Build and Compile.)

6.	Fix any errors detected during the build or compile process and repeat step 5.

Project Management Steps

Create a backup file for your project periodically.  (See Backups.)

Check the spelling of your text, keywords, titles, and macro commands.  (See Spell Check.)

Use Grapher to show connections for the entire project and show topics that are unconnected.  Connect or delete unconnected topics.  (See Grapher.)

Use Navigator to show connections for a single topic.  (See Navigator.)

Use Reporter to provide information about your project.  (See Reporter.)

Enhancement Steps

Create targets within topics to connect the reader to a specific location within the topic.  (See Targets.)

Insert pictures.  (See Pictures.)

Create hotspots on pictures that popup an explanation of a section of the picture.  (See Putting Hotspots on Pictures.)

Insert macro commands to create new buttons, to close secondary windows, to run other programs, and so forth.  (See Macros.)

Add embedded windows to access Windows' dynamic link libraries (DLLs).  (See Embedded Windows.)

Add baggage files if needed for DLLs.  (See Baggage.)

Add context numbers if your help file provides context-sensitive help for an application program.  (See Context-Sensitive Help.)

Create secondary window classes for information (such as, a list of references, examples, glossary terms) that the reader can display while moving through topics in the main WinHelp window.  (See Window Classes.)


Style

A style is a collection of character and/or paragraph formats saved by name.  You can apply the style to a paragraph or paragraphs to save formatting time and provide consistency to the different components of your text.  See Styles.


Styles

A style is a collection of character and paragraph formats that you have saved under a name.  You can format paragraphs quickly and consistently by applying a style to whole paragraphs at a time.  Some things to know about styles are:

Styles affect all the text in a paragraph.  To change the format of only a portion of a paragraph, select the text and use the Character Format dialog box.

Important:  Character and paragraph format changes applied to text outside assigned styles always override style settings using the same options.  When you apply a style to text that has character or paragraph formatting applied, you might see no change or only partial changes.  To reverse such local changes when applying a style, select the text, and press the [image] [image] keys or click on the [image] toolbar button.

All paragraphs use a style.  The default style in use when you first create a project is the Base style.  The default style for the banner area is the Banner Base style.  ForeHelp also provides List1, List2, and List3 styles for use with bullets and numbered lists.  You can change any of these style definitions using the Edit Style dialog box.

If you delete the paragraph symbols ( [image]) separating paragraphs that have different styles, the second paragraph becomes part of the first paragraph and adopts the first paragraph's style.

If you insert an .RTF file from your word processor or paste .RTF text from the Clipboard, ForeHelp copies the styles used in the file.  If your ForeHelp project and the inserted file use the same style names, you can choose to override the ForeHelp style definitions, override the inserted style definitions, or retain both style definitions.  See Inserting Rich Text Format (.RTF) Files or Paste Special for instructions.

You can define a new style based on an existing style definition.  Be careful if you change a style on which other styles are based.  Changes to the Based On style also reflect in the styles that use it as a base.


Table of Contents

This topic contains the following sections:

To Insert a Table of Contents of Selected Topics

Create Table of Contents Dialog Box

You can easily create a table of contents that contains jumps or popups to other topics in the same database.  This feature facilitates creating your project's Contents topic, see also lists, and glossary lists.

ForeHelp lets you select from all topics in the database and allows you to enter the title of a new topic.  It then inserts a list of the selected topic names at the cursor location in the current topic and makes jumps from each name to the appropriate topic.  If you enter a new topic title, ForeHelp creates a new topic with that title.

To modify the list after you have created it, use ForeHelp's standard features for cutting and pasting text and editing jumps and popups.

ForeHelp does not support interfile jumps with this feature.

To Insert a Table of Contents of Selected Topics

1.	Place the cursor at the location where you want ForeHelp to insert the table of contents.

2.	Choose the Topic|Generate Table of Contents command to access the Create Table of Contents dialog box.

3.	From the list in the All Topics box, select the topics you want to appear in the table of contents.

4.	To create a new topic and add it to the table of contents, enter the new topic title in the All Topics text box.

5.	Choose the Add button.
The selected topic title appears in the Topics list box and is removed from the All Topics list.

6.	To add all topics in the project at one time, select the Add All button.

7.	To modify the list:

To reorder the topics in the Topics list, select a topic title and either the Up button or the Down button.  The topic title moves one line in the specified direction.

To arrange the topics in alphabetical order, select the Alphabetize button.

To create popups instead of jumps to the selected topics, check the Make Popups box.

To remove a topic from the Topics list, select the topic title and then the Remove button.

To remove all of the selected topics from the Topics list, select the Remove All button.

8.	Choose the OK button.
ForeHelp creates the list as it appeared in the Topics list and inserts the list at the cursor location in the current topic.

Create Table of Contents Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Tables

ForeHelp provides a table editor that lets you format text into rows and columns.  Each intersection of a row and column is a table cell.  ForeHelp treats each cell as a separate paragraph.  You can enter text or insert graphics within a table cell.  You can apply paragraph styles, paragraph formatting, and character formatting to text within each cell.  Text that is longer than the width of the cell wraps within the cell.  ForeHelp adjusts the height of the row to be the size of the largest cell.

The width of the cell is 2 inches by default.  You can change this default using the Format|Table Cells command.  You can have WinHelp automatically enlarge the width of the cells to fit the window, but the cells are never smaller than the size that you specify for the cell.  If a row is larger than the width of the window, horizontal scroll bars appear.  For example, if you create a table with 3 columns, specify the Autosize Cell Width feature, and set the cell width to 1.5 inches, each column is 2 inches wide when the window is 6 inches wide.  When the reader resizes the WinHelp window to 4 inches wide, each column is 1.5 inches wide and scroll bars appear to enable the reader to view all of the text in the rightmost column.

You can display table gridlines in the ForeHelp window by turning on Text Detail in the Preferences dialog box.  You can create borders in your table by formatting each paragraph within the table.  See Formatting Tables.


Tables Definition
Tables

Tables allow you to create and edit text organized into rows and columns (cells).  See Tables.


Target

A target is a point in a topic that is linked to a jump or popup, allowing the jump or popup to go to the related information at the target location for viewing by the user.  Every topic has a default target whose name is the topic's context string.  You can add additional targets within longer topics.  See Targets.


Targets

A target is a location in a topic that is the destination of a jump or popup.  Every topic has a default target created at the time the topic is created.  The default target is located at the very beginning of the topic text (below the banner), although you cannot see it.  The name of the target is in the Context String field of the Topic Properties dialog box for the topic.  This is the only target you need in a topic if you want the jump or popup to display the topic at the beginning of the text.

In long topics, you can add several targets so that a reader can jump to a specific area within a topic.  Whenever possible, place targets at the beginning of a paragraph so that topics display correctly.  With text detail on, targets (except the default targets) display as an arrow ( [image]).

When you add a target to a topic, the Make Jump dialog box and the Make Popup dialog box list the target's context string indented beneath the topic's title.  The Goto dialog box lists the topic titles by default, but you can list the context strings for all targets (indented beneath the topic titles) by checking the Show Aliases And Targets box.


Template

A template is a blueprint of a project containing information, such as format styles, hotspots, macros, path definitions, and/or text, that you want to use in other projects.  You can open any ForeHelp database as a template using the New/Open/Open As Template dialog box.  You must provide a new name for the new database.  See Templates for instructions.

You can create templates that contain only the definitions that you use in most projects.  For example, you can create a template containing your standard style definitions, window classes, and button macros.


Templates

This topic contains the following sections:

To Open a Project as a Template

To Modify Definitions within a Template Project

New Database Name Dialog Box

A template is a help database that you use as the basis for creating another help project.  A template can contain any of the elements of a help project such as topics, text, paragraph styles, formatting, graphics, macro commands, window classes, and so forth.  You can open any help project as a template.  If you use standard elements in all of your help projects, you can create a small database that contains the definitions for your standard elements.  Each time you start a new project, you simply open this database as a template and start adding your new topics and text, without having to redefine styles, macro commands, or window classes.

When you open a database as a template, you must provide a unique name for the new project.  ForeHelp makes a copy of the database under the new name and opens this copy.  All of your changes are made to the new database and the template remains untouched.

To Open a Project as a Template

1.	Choose the File|New/Open command, press [image] [image], or click on the [image] toolbar button to access the New/Open/Open As Template dialog box.

2.	In the List Files of Type field, select ForeHelp Database.  You cannot open a project file (.HPJ) or a backup file (.FHB) as a template.

3.	In the File Name field, select the database name that you want to use as the template.

4.	Choose the Open Template button.
The New Database Name dialog box appears with the selected database and its path entered in the File Name field.

5.	In the File Name field, enter a unique name for the new project.

6.	Select another drive or directory in the Drives and Directories lists, if desired.

7.	Choose the OK button.
ForeHelp copies the project you selected as the template, names the copy with the name you just entered, and opens the copy for you to edit.

8.	Choose the Project|Properties command to change the title of the new project.  See Project Properties dialog box.

9.	Edit the file as appropriate for your application.

To Modify Definitions within a Template Project

You can modify a project that you use as a template just as you modify any other help database.

1.	Choose the File|New/Open command, press [image] [image], or click on the [image] toolbar button to access the New/Open/Open As Template dialog box.

2.	In the File Name field, select the template project that you want to modify.

3.	Choose the OK button.
ForeHelp opens the project that you are using as a template.

4.	Modify the project as needed.

New Database Name Dialog Box

Click on the parts of the box below where [image] appears for explanations of features.


Test Mode

Test mode allows you to instantly view and work with your project in a simulated WinHelp environment.  Without having to build and compile your project--which can be quite time consuming--you can test jumps, popups, browse sequences, window classes, and most macros as the reader ultimately will use them.

The Test window, like the WinHelp window, is the size and position as saved in the WIN.INI file the last time you closed a Help application.  If you specified a size and position of your project's main window class in the Window Classes dialog box, the window is opened using those settings.

Some features are not supported in the Test mode, including most WinHelp menu items, some interfile macros, and embedded windows.

To Access Test Mode

Choose the Project|Test command, press [image], or click on the [image] toolbar button.  ForeHelp displays your current topic in the Test window.

To Exit Test Mode

Close the window using the Control Menu or press [image] [image], just as you would close any other window.  (You must also close the secondary window, if open.)  You then return to the ForeHelp window.


Test Mode Definition
Test Mode

Test mode allows you to instantly test jumps, popups, browse sequences, and most macros without first building and compiling your help file.  The interface looks and behaves similarly to the help file the reader uses.  Close or exit the Test window to return to the ForeHelp window.  Access Test mode by choosing the Project|Test command, pressing [image], or clicking on the [image] toolbar button.


Testing Your Project

ForeHelp provides three features to confirm that your help project is error free when complete:  Test Mode, Build/Compile, and launching the .HLP file in WinHelp.

Test mode, accessed by Project|Test, [image], or [image], lets you instantly view your topics and test hotspots and browse sequences exactly like the finished help project.  You can use Test mode frequently as you progress.

Build and Compile, accessed by Project|Build, [image], or [image], find errors and create the final Help product.  You can choose to build and/or compile after completing any portion of your project.

Build creates a .HPJ and a .RTF file, which are needed to compile the final help project.  Build has a built-in error checking facility.  When you double-click on the message in the Build Status window, ForeHelp places your cursor at the error location within your project.  You can correct any errors detected prior to compiling.

Compile runs the WinHelp compiler to create the .HLP file using the .HPJ and .RTF files.

WinHelp, accessed by Project|WinHelp, [image], or [image], launches WinHelp using your .HLP file.  Use the WinHelp option after compiling to see your final project as the reader will.


Text Detail

Text detail means the non-printing characters that are used to help you format text and work with ForeHelp’s hotspots and targets.  These characters include the space ( [image]), paragraph ( [image]), line break ( [image]), target ( [image]), tab symbol ( [image]), text keyword marker ( [image]), table gridlines, and the corner brackets around hotspots ( [image] [image]).  You can turn the text detail display on or off in the Preferences dialog box or by clicking on the [image] toolbar button.


Text Editing

A help project consists of many topics, each of which contains your text and may contain pictures, hotspots, and macros.  When you start a new project, ForeHelp creates one topic, the Contents topic, and displays it with an empty workspace.

You can enter text for this topic using the keyboard or by inserting an .RTF or .TXT file.  See Text from Other Files.

To start additional topics, see Creating New Topics.

ForeHelp can display non-printing text detail characters that help you format text and work with hotspots and targets.

When working with topic text, you can use Find to search for and replace text strings as well as establish hypertext links and insert keywords.  See Find and Replace.

You can modify the text's appearance and position on the page using commands from the Paragraph Format dialog box.

You can modify the appearance of some words by using commands from the Character Format dialog box.

Important:  Changes made in the Character Format dialog box for selected text overrides style settings of the same options.  To reverse any such local changes when trying to apply a style, select the text, and press [image] [image] or click on the [image] toolbar button.  See Applying Styles.


Text Find Dialog Box

When Find locates an occurrence of the Search For string and an If Found action is required, the Text (or Macro, Topic Title, or Keyword) Find dialog box appears.

Click on the parts of the box below where [image] appears for explanations of features.


Text Menu

Command	Keyboard	Toolbar	Description
Make/Edit Jump...			Makes a jump from selected text to a designated target.  Edit Jump lets you redirect or remove the selected jump.
Make/Edit Popup...			Makes a popup from selected text to a designated topic.  Edit Popup lets you redirect or remove the selected popup.
Make/Edit Macro...			Makes a macro from selected text.  Edit Macro lets you change or remove the selected macro.
Insert Target...			Inserts a target at the cursor location within a topic as the destination for a jump or popup.
Insert Text Keyword...			Inserts a text (midtopic) keyword marker at the cursor location within a topic.
Edit Hotspot...			Lets you redirect or remove the selected jump, popup, or macro.  Depending on the selected hotspot, it is the same as Edit Jump, Edit Popup, or Edit Macro.
Make Multiple Jumps			Enabled when you select a list of text entries.  Creates a new topic and makes a jump from each entry to its corresponding topic.
Make Multiple Popups			Enabled when you select a list of text entries.  Creates a new topic and makes a popup from each entry to its corresponding topic.
Make Topic Keyword			Creates a keyword using the selected text and inserts it into both the master keyword list and the list for this topic.
Insert File...			Inserts an .RTF or .TXT file into your database.
Insert/Edit Picture...			Inserts or edits a .BMP, .WMF, .SHG, or .MRB picture file at the cursor location.
Insert Embedding...			Inserts an embedded window in which a DLL program runs after compiling.
Insert Special			Inserts an embedded window for a DLL that ForeHelp provides.
Insert Table...			Creates a table using the Table Size dialog box.
Insert a Row			Appears on the menu only when the cursor is in a table.  Inserts a row on top of the row in which the cursor is located.
Insert a Column			Appears on the menu only a column in a table is selected.  Inserts a column in front of the selected column.
Insert Bullets...			Accesses the Bullets And Numbering dialog box to insert bullets or numbers in front of the selected paragraphs.  The toolbar button inserts bullets or numbers using the last settings in the dialog box.
Hard Space			Creates a hard (nonbreaking) space at the cursor location.  Use a hard space to keep certain words together when the text automatically wraps.
Line Break			Inserts a line break symbol ( [image]) and creates a new line within the same paragraph at the cursor location.


Text Path and Graphic Path

This topic contains the following sections:

To Select an Existing Directory

To Create a New Directory

Text Path or Graphic Path Dialog Box

ForeHelp displays the Text Path dialog box when you select the Text Path button in the Project Paths dialog box.  It displays the Graphic Path dialog box, which is identical to the Text Path dialog box, when you select the Graphic Path button.  (This topic shows only the Text Path dialog box.)

You can list more than one directory.  When ForeHelp looks for files during the build process, it looks in all listed directories.  When ForeHelp creates files during the build process, it places the files in the first directory in the list.

To Select an Existing Directory

1.	In the Directories and Drives fields, select the drive and directory where you want ForeHelp to place the .RTF file(s) or graphic files it creates during the build process and where ForeHelp looks for files during the build process.

2.	To add another text or graphics directory, select the Append button.  ForeHelp adds the new directory to the list in the Text Path or Graphics Path field of the Project Paths dialog box.
To use the selected directory instead of the text or graphics directory, select the Replace button.
The selected drive and directory path appear in the Text Path or Graphics Path field of the Project Paths dialog box.

To Create a New Directory

1.	In the Text Path dialog box, select the Create button to access the Create Directory dialog box.

2.	Enter the name of the directory you want ForeHelp to create.

3.	Choose the OK button.  The Text Path dialog box is now active.

4.	To add this directory to the text or graphics directory, select the Append button.
To use the selected directory instead of the text or graphics directory, select the Replace button.
The selected drive and directory path appear in the Text Path or Graphics Path field of the Project Paths dialog box.

Text Path and Graphic Path Dialog Boxes

Text Path and Graphic Path dialog boxes have the same options.

Click on the parts of the box below where [image] appears for explanations of features.


Text from Other Files

You can insert or paste text from files created in other software packages into a ForeHelp project.  ForeHelp provides several options:

You can insert entire .RTF files into your current project or recreate a help project from its .RTF file(s).  See Inserting Rich Text Format (.RTF) Files.

You can insert entire .TXT files as plain text into the current topic.  See Inserting Text (.TXT) Files.

You can paste selected text from the Clipboard into the current topic.  See Cut, Copy, and Paste.

You can paste selected text that was copied from a software package that supports .RTF format to retain styles and to create separate topics for each page in the file.  See Paste Special.


Toolbar Buttons

The following is an alphabetical list of the toolbar buttons.  Click on a button to jump to the button's related topic.

Button	Description

Creates aliases for topics or targets.

Automatically assigns context numbers to all topics in the project.

Moves to the previously displayed topic.

Creates a compressed archive file of the current project.

Adds baggage files to your project.

Enables you to define browse sequences using the Project Browse Sequences dialog box.

Accesses the Build dialog box to build and compile your project.

Inserts bullets or numbers for text lists, using the previously selected bullet picture or number.

Accesses the Window Classes dialog box to define main and secondary windows.

Closes the current project.

Moves to the Contents topic of the project.

Duplicates the selected text or graphics and places them on the Clipboard.

Accesses the Context Mapping dialog box to assign context numbers.

Removes the selected text or graphics and places them on the Clipboard.

Turns text detail on or off.

Edits a jump, popup, or macro.  Brings up the appropriate dialog box based on the type of hotspot where the cursor is located.

Enables you to change a style definition.

Locates selected text and replaces it with other text or makes into a hotspot or keyword.

Changes font formats.

Accesses the Goto dialog box to move to another topic.

Accesses the Grapher.

Displays a secondary window with a list of the last 40 viewed topics.

Insert .RTF or .TXT file into project.

Inserts or edits a jump.

Makes jumps from several selected paragraphs to new destination topics.

Accesses the Topic Keyword dialog box to insert or edit keywords.

Inserts or edits a macro command.

Assigns the selected text as a keyword for the current topic.

Accesses the Navigator.

Creates a new topic.

Advances to the next topic in a browse sequence.

Accesses the New/Open/Open As Template dialog box, in which you can open a new or existing project.

Changes paragraph formats.

Inserts text or graphics from the Clipboard into your project.

Inserts .RTF text from the Clipboard into your project, allowing you to break the text into separate topics and providing style options.

Inserts a graphic file or edits an existing graphic in your project.

Inserts or edits a popup.

Makes popups from several selected paragraphs to new destination topics.

Moves to the previous topic in a browse sequence.

Accesses the Print Topics dialog box so that you can select and print topics.

Accesses the Reporter.

Restores the current project to the state it was in when you last saved it or last opened it (whichever is more recent).

Restores any paragraph or font changes to the style assigned to the paragraph.

Removes the ruler if it's displayed; displays the ruler if it's not displayed.

Writes all changes made in the current project to the original database files on the hard disk.

Searches the project file using keywords.

Starts the Spell Check feature.

Applies a defined style to the selected paragraph.

Inserts or edits a table.

Inserts or edits a target at the cursor location.

Inserts a row or column in a table.

Enters Test mode to show how your final help file will look.

Starts the Thesaurus.

Creates a new topic based on the current topic.

Deletes the current topic.

Accesses the Topics Properties dialog box.

Reverses the last text action.

Accesses the WinHelp system if you have built and compiled an .HLP file for the current project.


Tools Menu

Command	Keyboard	Toolbar	Description
Navigator...			Displays the Navigator where you can navigate through your topics using their links and view their jump, popup, and browse relationships.
Grapher...			Displays the Grapher where you can view your project in a hierarchical, outline format as well as see all disconnected topics.
Reporter...			Select any or all topics and any of a number of fields to display and print list of jumps, popups, browse sequences, keywords, and other information.
Find...			Searches for text and selects it or replaces it with text, hotspots, or keywords using the Find dialog box.
Find Again			Repeats the Find operation.
Spell Check...			Checks spelling in topics, macros, titles, and keywords via the Spelling Options and Check Spelling dialog boxes.
Thesaurus...			Displays a thesaurus with alternative words and their meanings for selected text via the Thesaurus dialog box.


Topic

The topic is the basic unit of the help project.  A topic is similar to a book’s chapter (though it is usually short) and contains related information on one subject.  Each topic has at least one target which is at the beginning of the topic.


Topic Menu

Command	Keyboard	Toolbar	Description
Properties...			Create or change topic characteristics such as context number and banner via the Topic Properties dialog box.
Keywords...			Create, view, or assign keywords to topic(s) via the Topic Keywords dialog box.
Macros...			Create macros that run when the topic is opened via the Topic Macros dialog box.
Contents			Displays the Contents topic.
Search...			Perform keyword search via the Search dialog box.
Back			Displays the topic you previously viewed.  Moves back through the History.
History...			Displays the history in a list box of topics you've viewed in reverse order.  Double-click to go to a listed topic.
Previous			Moves to the previous topic in the current browse sequence.
Next			Moves to the next topic in the current browse sequence.
Goto...			Displays a list of topics.  Double-click on the topic you want to go to.
Goto Next Topic			Moves to the next topic (alphabetically) in the Goto list of project topics.
Goto Previous Topic			Moves to the previous topic (alphabetically) in the Goto list of project topics.
New...			Creates a new topic using the Topic Properties dialog box.
Delete			Deletes the current topic.
Copy Topic...			Creates a new topic with the attributes and optionally the text, graphics, macros, and the hotspots of the current topic.  Accesses the Copy Topic dialog box.
Generate Table of Contents...			Creates a list of topic names at the cursor location in the current topic, using the Create Table of Contents dialog box.  Each topic name in the list is made into a jump or popup that accesses the associated topic.


Topic Properties Dialog Box

The first topic in a project is always the Contents topic. When you create a new project, the Topic Properties dialog box displays automatically with Contents in the Topic Title field.  To create additional topics, see Topics.

You can always edit the Topic Properties dialog box when the topic is displayed by choosing the Topic|Properties command, pressing [image] [image], or clicking on the [image] toolbar button.

Click on the parts of the box below where [image] appears for explanations of features.


Topics

The topic is the basic unit of your help project and can be any length.  The topic can contain text and graphics.  The reader can access only the topics to which you have provided connections.  These connections can be jumps or popups from the Contents topic or other topics, browse sequences, or keywords.

If a topic is wider than the reader's window (and can't wrap to the window size because of tables, graphics, do not wrap option, etc.) or contains more text than can display in one window, horizontal and/or vertical scroll bars appear to enable the reader to view the entire topic by scrolling.


Understanding ForeHelp Project Files

This topic contains the following sections:

Database (.DBA) Files

Temporary (FHXXXXXX.DBA and $filenam.DBA) Files

Backup (.FHB) Files

Graphic (.BMP, .MRB, .WMF, .SHG) Files

Project (.HPJ) and Rich Text Format (.RTF) Files

Help (.HLP) Files

Database (.DBA) Files

ForeHelp organizes your help file as a set of database files with the extension .DB*.  For each file, the * is replaced by a unique letter from A through G.  ForeHelp refers to these files as your help database or your .DBA file.  These files work together and you should not separately delete or move any of the files within the set.  (The Reporter can display and print the sizes of these files for your project.)

When you open a project, you are actually opening the set of database files.  By default, ForeHelp makes a temporary copy of your database when you open it.  As you modify the database, ForeHelp modifies the copy and not the original.  When you close the database normally, ForeHelp overwrites the original database with the modified copy.  You can also have ForeHelp save your changes to the original database at any time while you are working in the database file.  See Saving Your Project.

If you clear the Edit Copy check box in the New/Open/Open As Template dialog box when you open a database, ForeHelp does not use a temporary database.  It writes all modifications directly to the original database on the hard disk.  Using this option, you cannot revert to a previously saved state.  If your computer should crash, you risk corrupting your original database.

Temporary (FHXXXXXX.DBA) Files

If ForeHelp exits abruptly and you are editing a copy of the database, ForeHelp does not overwrite the original database.  Instead, it retains the modified copy, which is named FHXXXXXX.DBA (where XXXXXX is a randomly generated number).  When you start ForeHelp again, ForeHelp lets you choose to attempt to recover the changes made in the temporary database or to revert to the original database.  If you choose the recover option, ForeHelp renames your original database to $filenam.DBA (where filenam is the first 7 characters of your database name).  It then validates the temporary database.  If the file is corrupt, it displays a message, does not permit you to recover, and renames your original database with its correct name.  If the temporary file is fine, ForeHelp opens the temporary file, renames it as filename.DBA (where filename is the name of your original file), and deletes the original file.  Depending on the circumstances of the abrupt closure, you might see the changes you made since the last time you saved during the last edit session or you might have lost them.  If you choose the revert option, you lose all changes made since the last time you saved the project during the last edit session.

Backup (.FHB) Files

You can also create a compressed file of the text, graphics, and baggage files for your project.  The compressed file is called a backup file and has the extension .FHB.  You can create a backup or expand a backup file at any time.  See Backups.

Graphic (.BMP, .MRB, .WMF, .SHG) Files

You can insert picture files into your ForeHelp project.  ForeHelp can insert and display any Windows-compatible graphic file, such as bitmaps (.BMP), multi-resolution bitmaps (.MRB), and Windows metafiles (.WMF).  You can place hotspots on sections of pictures.  To do this, you use ForeHelp's Sheg Editor.  When you exit the Sheg Editor, ForeHelp creates a segmented hypergraphic (.SHG) file that contains the hotspot information.

Project (.HPJ) and Rich Text Format (.RTF) Files

When you build the project, ForeHelp creates two files, the project file with an .HPJ extenstion and the text file(s) with an .RTF extension.  ForeHelp lets you open an .HPJ file created by ForeHelp or by any other software package.  When you open an .HPJ file, ForeHelp recreates a database for it.  You must have the .RTF file(s) available when you open an .HPJ file.  See Opening an Existing Help Project.

ForeHelp lets you organize your topics into different .RTF files for the build process.  You can also insert .RTF files created by ForeHelp or word processing software into a help database.  Using these two features together, you can easily create common help topics that are used in different databases.  See Using Topics in Multiple Databases.

Help (.HLP) Files

The WinHelp compiler requires both the .HPJ and .RTF files as input to compiling your final help file.  Your final help file has the extension .HLP.  The help file is an executable file that the reader can run in Windows or can launch through an application.


Using Find and Replace

This topic contains the following sections:

To Find Text

Find Dialog Box

To Find Text

1.	To access the Find dialog box, choose the Tools|Find command, press [image] [image], or click on the [image] toolbar button.

2.	In the Search For field, enter the text you want to find.

3.	Check the Case Exactly box if you want Find to select text that matches your entry exactly as you typed it.

4.	Check the Whole Words Only box to select text that appears as a word rather than as part of longer word.

5.	From the If Found drop-down list box, select an operation to be performed when the text is found.  See Find Operations.

6.	In the Look Where box, select the range of topics where ForeHelp should look for the text: all topics, the current topic only, or the browse sequence to which the current topic belongs (if any).

7.	If you selected Select or Replace Text as the If Found operations, you can also select where ForeHelp should search: topic text, keywords and titles, and/or macro arguments.

8.	Choose the OK button.
ForeHelp searches for the specified text string.  If it finds the string, it displays the topic or title where the string is located and highlights the string.  Depending on your If Found and Search Where selections, ForeHelp may display the Text Find dialog box.  If it cannot find the string, ForeHelp displays a message informing you of this.

Click on the parts of the box below where [image] appears for explanations of features.


Using Jumps and Popups

This topic contains the following sections:

Using Hotspots in ForeHelp

Using Hotspots with the Mouse in WinHelp or Test Mode

Using Hotspots with the Keyboard in WinHelp or Test Mode

In the ForeHelp window, you can easily move to the topic linked to a hotspot.  ForeHelp displays the topic in the workspace; it cannot show a popup window or a secondary window.   To test the your hotspots in their appropriate windows, you can enter Test mode or build your project and use WinHelp.

Using Hotspots in ForeHelp

You can move to the topic linked to a hotspot to enter new text, change the topic's properties, or test that you selected the correct target.

1.	Press [image] while you move the mouse cursor over a hotspot.  The cursor changes to a hand [image].

2.	Click the left mouse button to activate the jump or popup.  ForeHelp displays the target in the workspace.

3.	Press [image] [image] to return to the topic containing the hotspot.

Using Hotspots with the Mouse in WinHelp or Test Mode

To enter Test mode, choose the Project|Test command, press the [image] function key, or click on the [image] toolbar button.

To enter WinHelp, choose the Project|WinHelp command, press the [image] function key, or click on the [image] toolbar button.

1.	When your or your reader point to a hotspot, the mouse pointer changes to a hand [image].

2.	Click the left mouse button to activate the jump or popup.

3.	Press [image] [image] to return to the previous topic from a jump; click the mouse or enter any keystroke to remove a popup from the screen.

Using Hotspots with the Keyboard in WinHelp or Test Mode

To enter Test mode, choose the Project|Test command, press the [image] function key, or click on the [image] toolbar button.

To enter WinHelp, choose the Project|WinHelp command, press the [image] function key, or click on the [image] toolbar button.

1.	Move a highlight through hotspots by pressing [image], or move through hotspots in the reverse direction by pressing [image] [image].

2.	Press [image] to activate the hotspot.


Using Navigator

This topic contains the following sections:

To Access the Navigator

To Display a Topic's Relationships

To Change the Topic in the ForeHelp Window Using Navigator

To Access the Navigator

Choose the Tools|Navigator command or the [image] toolbar button to access the Navigator Window.

To Display a Topic's Relationships (move it to the center)

Open the Navigator when the topic is in the ForeHelp window, or

Double-click on a topic displayed in the Navigator window, or

Change topics in the ForeHelp window, select File|Navigate to Main Window's Topic from Navigator's menu bar, or the [image] button in the Navigator window.

To Change the Topic in the ForeHelp Window Using Navigator

Click the Glasses icon in the corner of any visible topic.  The highlight displays in the current topic in the main ForeHelp window.


Using Search

The ForeHelp Search feature works the same as Search in WinHelp.  You can use keywords to locate related information in topics throughout your project.  Each time you access Search, the Search dialog box displays the parameters from the previous search request.

1.	From the ForeHelp window, choose the Topic|Search command, press [image] [image], or select the [image] toolbar button to access the Search dialog box.  From Test mode or from WinHelp, select the Search button.

2.	Select the keyword you want to find, using one of the following methods:

Type the keyword into the text box.  The words in the list box move to display the closest match at the top of the list.  Select the keyword when it appears in the list box.

Use the vertical scroll bar to scroll through the list.  Select the keyword when it appears in the list box.

Press [image] to access the keyword list.  The first word in the list is highlighted.  Use the following keys to move the highlight:

Goes to the last word in the list

Goes to the first word in the list

 or 	Goes up one word

 or 	Goes down one word

Goes up five words at a time

Goes down five words at a time

3.	Show the highlighted keyword's related topics in one of the following ways:

Choose the Show Topics button.

Double-click on the entry in the list box.

Press [image].

4.	Select a topic from the list of displayed topics and choose the Go To button, or double-click on the topic.  If you accessed Search from the ForeHelp window, ForeHelp displays the selected topic in this window.  If you accessed Search from Test mode or from WinHelp, the Help window displays the selected topic.


Using Special Characters

Each font has its own extended character set--special characters you can use that are not shown on your keyboard.  There are two ways to enter special characters in ForeHelp:

Access [image], a Windows utility found in the Accessories program group.  You can select a font from the drop-down list, view its template, and copy whichever character you want to the Clipboard.  You can then paste it into your ForeHelp file.  See your Windows documentation or Character Map's help file for more information.

Enter characters directly in ForeHelp if you know their ANSI code.  (The Character Map shows the ANSI code of the selected character in its status bar next to Keystroke: Alt+.)  Place the cursor where you want the special character, turn on your keyboard's NumLock, press and hold the Alt key, and then type the ANSI code on the numeric keypad.  Examples:  In many fonts, Alt+0169 gives a copyright symbol (©) and Alt+0149 gives a bullet (•).

 Important	When you use characters that may not be available on readers' systems, ForeHelp displays a warning for each character when you build the help file .  For example, WinHelp does not support character bullets.  The bullet in the parentheses at the end of the preceding paragraph causes a warning message.  (ForeHelp uses picture bullets to work around WinHelp's restriction.)


Using Topics in Multiple Databases

This topic contains the following sections:

To Include Standard Elements in Every Database

To Split a Large File into Several Smaller Files

To Use Several Help Files Seamlessly

There are frequently times when you need to use the same topic in different help files.  For example:

Your company always includes standard topics within their help files, such as common glossary terms or how to obtain customer support.

You always use the same styles and buttons in each project.

You might have created one large help project and now realize that you need to create subsets of the project to support related applications.

ForeHelp provides several methods that enable you to easily share topics, graphics, macro commands, and other elements between files:

To Include Standard Elements in Every Database

Create a database that contains your standard definitions of such elements as text, styles, macro commands, window classes, and graphics.  When you start a new database, open the database containing the standards as a template.  See Templates for instructions.

To Split a Large File into Several Smaller Files

By default, ForeHelp assigns all topics to an .RTF file that is in the same directory and has the same base name as your database files.  When you build the project, you can build all topics or select a subset.  You can also select the .RTF files where ForeHelp writes the topics during the build process.  See Creating Rich Text Format (.RTF) Files for instructions.

If you built a single subset of topics, you can open the .HPJ file using the File|New/Open command.  ForeHelp recreates the database for this subset of topics.

If you built all topics, you can open an existing database or start a new database in which you want to include one or more subsets of the topics from the original database.  Choose the Text|Insert File command to import the .RTF file created by ForeHelp.  See Inserting Rich Text Format (.RTF) Files for instructions.

To Use Several Help Files Seamlessly

You can organize topics into different databases.  To enable your user to move between the files seamlessly and transparently, create interfile jumps and popups.  Then build and compile each database into a separate .HLP file.  When you deploy your help file with its product application, ensure that you include all .HLP files in the setup program.


Using Window Classes

This topic contains the following sections:

To Create a Jump Using a Window Class

To View Window Classes in Test Mode

To View Window Classes in the Help File

To Close the Secondary Window after Use

To see how secondary windows look and behave, you must first create jumps from the main window to another target specifying a secondary window.

To Create a Jump Using a Window Class

You can create jumps from the main window to a secondary window, from the secondary window back to the main window, or from one secondary window to another secondary window (only the destination secondary window will display).

1.	Choose the Text|Make Jump command, press [image] [image], or click on the [image] toolbar button.

2.	In the Target field, select the topic or target to jump to.

3.	From the Window drop-down list, select the window class in which to display the target topic.  If you select the default <none>, the target topic displays in the same window class as the topic containing the jump hotspot.

4.	Choose the OK button.

See Jumps and Popups for more information.

To View Window Classes in Test Mode

1.	Choose the Project|Test command, press [image], or click on the [image] toolbar button to access Test mode.

2.	Click on the jump hotspot in the main window to display the secondary window.

To View Window Classes in the Help File

1.	Choose the Project|Build command, press [image], or click on the [image] toolbar button to build and compile your project.

2.	Choose the Project|WinHelp command, press [image], or click on the [image] toolbar button to run the  *.HLP file.

3.	Click on the jump hotspot in the main window to display the secondary window.

To Close the Secondary Window after Use, either

Close the window manually as you would any other window by using the Control Menu or [image] [image], or

Automate closing the window by using the CloseWindow macro (as a hotspot in the window, as a button, or as a menu item).  See Macros.


Using the Format Bar

This topic contains the following sections

To Assign a Character Font Using the Format Bar

To Change the Font Size Using the Format Bar

To Apply Bold, Italics, or Underlining Using the Format Bar

To Apply a Paragraph Style Using the Format Bar

To Remove the Format Bar from the ForeHelp Window

To Display the Format Bar in the ForeHelp Window

The format bar appears above the topic text workspace in the ForeHelp window.  This bar displays the current font and style assignments for the paragraph containing the cursor or for any selected text.  You can use the format bar to assign character fonts and paragraph styles without accessing dialog boxes.  You can remove the format bar to create additional workspace for your topics.

To Assign a Character Font Using the Format Bar

1.	Place the cursor where you want to start typing new text in the topic, or select existing text.

2.	Click on the down arrow next to the character font field to display the list of fonts available on your system.

3.	Select a font.
ForeHelp changes the font for the selected text and for any text that you enter at the cursor position.

To Change the Font Size Using the Format Bar

1.	Place the cursor where you want to start typing new text in the topic, or select existing text.

2.	Click on the down arrow next to the font size field to display the list of fonts available on your system.

3.	Select a size.
ForeHelp changes the font size for the selected text and for any text that you enter at the cursor position.

To Apply Bold, Italics, or Underlining Using the Format Bar

You use the font style buttons to apply bold, italics, or an underline to text in your topic.  When the selected text uses a font style, the corresponding button appears to be pushed in.  When part of the selected text uses a font style and part does not, the corresponding button appears pushed in and the letter is outlined rather than a solid color.  When the selected text does not use a font style, the button appears to be popped out.

1.	Place the cursor where you want to start typing new text in the topic, or select existing text.

2.	Select one or more of the three buttons:  for bold, [image] for italics, and [image] for underline.
ForeHelp applies the font style(s) to the selected text and to any text that you enter at the cursor position.

3.	If you selected a button prior to typing text, select the button a second time when you no longer want the font style applied.

To Apply a Paragraph Style Using the Format Bar

You can select any paragraph styles that you have previously defined for this project.  To define paragraph styles, see Creating New Styles.

1.	Place the cursor in the paragraph to which you want to apply a style.  To apply the same style to contiguous paragraphs, select all or part of each paragraph at the same time.

2.	Click on the down arrow next to the style name field to display the list of defined styles.

3.	Select a style.
ForeHelp applies the style to the selected paragraphs.

To Remove the Format Bar from the ForeHelp Window

You can remove the format bar from the ForeHelp window to enlarge your workspace.

1.	Choose the File|Preferences command to access the Preferences dialog box.

2.	In the Show section, clear the Formatting Tools check box.

3.	Select the OK button.
ForeHelp removes the format bar from the ForeHelp window.

To Display the Format Bar in the ForeHelp Window

1.	Choose the File|Preferences command to access the Preferences dialog box.

2.	In the Show section, check the Formatting Tools box.

3.	Select the OK button.
ForeHelp displays the format bar above the topic workspace in the ForeHelp window.


Using the Ruler

This topic contains the following sections:

Ruler Icons

To Remove the Ruler from the ForeHelp Window

To Display the Ruler in the ForeHelp Window

The ruler appears in the ForeHelp window immediately above the topic workspace.  The ruler displays the current paragraph margins and tab settings.  You can use the ruler to change these settings.  See Setting Paragraph Tabs and Setting Margins and Indentations.

Important:  Changes made to selected paragraphs using the ruler override style settings of the same options.  To reverse any such local changes when applying a style, select the text, and press [image] [image] or click on the [image] toolbar button.  See Applying Styles.

Ruler Icons

The ruler displays at the top of the ForeHelp window and provides shortcuts to changing tabs, indents, and margins.  (You can also make these changes using the Paragraph Format dialog box.)  The ruler has the following icons:

A default tab position.  These are left-aligned tabs that appear every 1/2" across the ruler.

An optional left-aligned tab position.

An optional right-aligned tab position.

An optional center-aligned tab position.

The right margin.

The default left margin.  It actually comprises two icons, which you can move separately:

The first-line indent (the one on top).

The left margin (the one below).

To Remove the Ruler from the ForeHelp Window

Click on the [image] toolbar button.

Or follow these steps:

1.	Choose the File|Preferences command to access the Preferences dialog box.

2.	In the Show section, clear the Ruler check box.

3.	Choose the OK button.
ForeHelp removes the ruler from the top of the ForeHelp window.

To Display the Ruler in the ForeHelp Window

Click on the [image] toolbar button.

Or follow these steps:

1.	Choose the File|Preferences command to access the Preferences dialog box.

2.	In the Show section, check the Ruler box.

3.	Choose the OK button.
ForeHelp displays the ruler at the top of the ForeHelp window.


Using the Status Line

This topic contains the following sections:

To Remove the Status Line from the ForeHelp Window

To Display the Status Line in the ForeHelp Window

The status line appears at the bottom of the ForeHelp window and displays the name of the current topic and the line on which the cursor is placed.  If the cursor is on a hotspot, the status line also shows the target to which the selected hotspot is connected or the macro associated with the macro hotspot.  If you click once on a graphic, the status line shows the file name and path of the graphic file.

The status line also displays temporary information and quick help, such as, menu option descriptions, toolbar button descriptions, dialog box field descriptions, and backup information.

To Remove the Status Line from the ForeHelp Window

1.	Choose the File|Preferences command to access the Preferences dialog box.

2.	In the Show section, clear the Status Line check box.

3.	Choose the OK button.
ForeHelp removes the status line from the bottom of the ForeHelp window.

To Display the Status Line in the ForeHelp Window

1.	Choose the File|Preferences command to access the Preferences dialog box.

2.	In the Show section, check the Status Line box.

3.	Choose the OK button.
ForeHelp displays the status line at the bottom of the ForeHelp window.


Using the Toolbar

This topic contains the following sections:

To Use a Button

To Remove Buttons

To Add Buttons

To Reorder Buttons

To Change the Location of the Toolbar

To Use Tool Tips

To Remove Tool Tips

To Change the Timing for Displaying Tool Tips

To Remove the Toolbar

To Remove the Text from the Buttons

The toolbar contains buttons that provide shortcut access to 50 commands on the ForeHelp menus.  By default, the toolbar appears at the top of the ForeHelp window with most of the available buttons.  Each button has a graphic and a label that provide visual cues as to its purpose.  The button appears in full color when the associated command is available and appears in gray when the command is unavailable.  See Toolbar Buttons for a description of each button.

ForeHelp lets you customize the toolbar for your needs: you can remove and add buttons, reorder buttons, move the toolbar to another position (including vertical) in the workspace, delete the labels from the button, remove the on-screen descriptions (tool tips), and remove the toolbar from the workspace altogether.

To Use a Button

1.	Click on a full-color button to issue the associated command.  This is equivalent to choosing a command from a menu or pressing the shortcut keys associated with the command.

To Remove Buttons

1.	Choose the File|Toolbar command.
Or click the right mouse button.
Or press [image] and click the left mouse button in an area of the toolbar that does not contain a button.

The Customize Toolbar dialog box appears.  This dialog box lists each button with an explanation of the button’s function.  By default, all buttons in the list are unavailable because they all appear on the toolbar.

2.	Choose a button from the Tools list and choose the Remove button.
Or double-click on a button in the Tools list.
ForeHelp immediately removes the button from the toolbar and makes it available in the Tools list.

3.	Remove as many buttons as you want.

4.	Choose the Close button when you are done.

To Add Buttons

1.	Choose the File|Toolbar command.
Or click the right mouse button in an area of the toolbar that does not contain a button.
Or press [image] and click the left mouse button in an area of the toolbar that does not contain a button.

The Customize Toolbar dialog box appears.  This dialog box lists each button with an explanation of the button’s function.

2.	Choose an available (full-color) button from the Tools list and choose the Add button.
Or double-click on an available button in the Tools list.
ForeHelp immediately adds the button to the last position of the toolbar and makes it unavailable in the Tools list.

3.	Add as many buttons as you want.

4.	Choose the Close button when you are done.

To Reorder Buttons

You can move the buttons to other positions on the toolbar.

1.	Place the mouse pointer on the toolbar button that you want to move.

2.	Click the right mouse button and hold it down.
Or press [image] while clicking and holding down the left mouse button.

3.	Drag the button to the button that is immediately to the left of the desired location.

4.	Release the mouse button.
ForeHelp inserts the dragged button to the right of the place where you released the mouse button.

To Change the Location of the Toolbar

1.	Double-click in the toolbar (but not on one of the tools) to turn it into a dialog box.

2.	Use the box's title bar to drag the box into the position you want.

3.	Drag the side border(s) to change its size and shape.  You can even make the toolbar vertical for placement alongside your text by dragging a side border all the way in.  ForeHelp remembers the shape the next time you open your file.

4.	Double-click in the Toolbar's dialog box (but not on a tool) to return it to its default position above the ruler.

To Use Tool Tips

A tool tip is a description of a button that appears on screen only when you want to view it.  You can only view tool tips when the toolbar is in its default location.

1.	Place your cursor over the button.

2.	After a 1 second delay (by default), a yellow box containing the description appears beneath the button and remains visible until you move the cursor.

To Remove Tool Tips

1.	Choose the File|Preferences command to access the Preferences dialog box.

2.	In the Toolbar section, clear the Tool Tips check box.

3.	Choose the OK button.

To Change the Timing for Displaying Tool Tips

1.	Choose the File|Preferences command to access the Preferences dialog box.

2.	In the Toolbar section, enter the number of seconds in the Tool Tip Delay field.

3.	Choose the OK button.

To Remove or Display the Toolbar

You can remove the toolbar from the ForeHelp window to increase your workspace.

1.	Choose the File|Preferences command to access the Preferences dialog box.

2.	In the Show section, clear the Tools check box to remove the toolbar; check this box to display it in the ForeHelp window.

3.	Choose the OK button.

To Remove the Text from the Buttons

You can remove the text label at the bottom of each button to create smaller buttons.  For example, [image] becomes [image].

1.	Choose the File|Preferences command to access the Preferences dialog box.

2.	In the Show section, clear the Button Labels check box.

3.	Choose the OK button.


Viewing Keywords

This topic includes the following sections:

To View a Topic's Keywords

To View the Topics Referencing a Keyword

ForeHelp enables you to view the list of topic and text keywords associated with a topic and to view all of the topics that contain a reference to a particular keyword.  You can also print a list of keywords and topics using the Reporter.

To View a Topic and Text Keywords for a Topic

1.	Choose the Topic|Keywords command, press [image] [image], or click on the [image] toolbar button to access the Topic Keywords dialog box.

2.	In the Topic drop-down list box, select the topic for which you want to see keywords.  The keywords associated with this topic appear in the Keywords list box.  Topic keywords appear as black text and text keywords appear as gray text.

3.	Choose the OK button.

To List the Topics Referencing a Keyword

The Edit Master Keyword List shows you the topics that reference a selected keyword.  You can access this list through topic keywords or through text keywords.

Through Topic Keywords:

1.	Choose the Topic|Keywords command, press [image] [image], or click on the [image] toolbar button to access the Topic Keywords dialog box.

2.	Choose the Edit button or press [image] [image] to access the Edit Master Keyword List dialog box.

Through Text Keywords:

1.	Choose the Text|Insert Text Keyword or Edit Text Keyword command or press [image] [image] to access the Keyword In Text dialog box.

2.	Choose the Keywords button to access the Edit Master Keyword List dialog box.

In the Edit Master Keyword List Dialog Box:

1.	In the Keywords list, select a keyword.  The topics that reference this keyword appear in the Topics list box.

2.	Choose the Done button.  The Topic Keywords or Keyword In Text dialog box reappears.

3.	Choose the OK button.


WIN.INI

WIN.INI is the Windows initialization file that contains startup settings on your system.  You can modify the settings in this file directly using a DOS editor, or you can use a number of ForeHelp dialog box commands to change the settings in this file.


What is ForeHelp

ForeHelp is a unique help authoring tool that enables you to quickly and easily create Windows help files, taking full advantage of all features of the Windows WinHelp system.  ForeHelp allows you to

Create hypertext hotspots on text or graphics

Define window classes

Create and modify browse sequences

Create Help macros

Incorporate embedded data from other applications

Insert dynamic link libraries (DLLs)

You can create help files using ForeHelp exclusively.  ForeHelp contains a capable word processor, which allows you to

Perform spell check on topic text and keywords--even check the spelling of macro arguments

Use a thesaurus

Use the advanced find facility to create hotspots and keywords automatically or to replace text

Create bulleted lists with a wide variety of bullet pictures

Create numbered lists using single or multiple (outline) levels and different styles of numbers or letters

Format text using the table editor

Format character and paragraph text using styles

You can insert and work with existing files, created in other software packages, such as

Help-authoring product .HPJ files

.RTF  and .TXT data files

.BMP, .WMF, .MRB and .SHG graphic files

ForeHelp offers special tools to help you manage your help project:

The Navigator displays your project in a graphic format showing topic associations.

The Grapher shows your project in a hierarchical outline format.

You can display and print out flexible project summaries using the Reporter.

Using the Test mode, you can instantly view and try out your help project as you progress.  You save time by not having to first build and compile the project before testing.


What's New in Version 2.0

This topic contains the following sections:

Add-On Products

Bullets and Numbered Lists

Compatibility

Context-Sensitive Help

Formatting

Generating Manuals

Pictures

Hotspots

Importing .RTF Files

Keywords

Macros

Navigation

Project Management

Tables

Topics

Window Classes

Windows Dynamic Link Libraries (DLLs)

Workspace Display

ForeHelp version 2.0 includes an impressive list of new features plus extensive enhancements of many standard features.  This topic provides a quick preview of these features with jumps to the appropriate topics for more information.

Compatibility

You can open existing ForeHelp databases with ForeHelp version 2.0.  ForeHelp automatically converts a version 1.x database to a version 2.0 database.  You cannot open a version 2.0 database with an older version of ForeHelp.  However, you can build a project file (with extension .HPJ) with version 2.0 and open it with version 1.x.  (See Opening an Existing Help Project.)

ForeHelp version 2.0 is compatible with Windows 3.1 and Windows NT.

Add-On Products
Button creation and selection utility	ForeFront Help Buttons
Help Browser 2 software that provides readers with a full-text search capability and navigation aids for your help file.	Help Browser 2
Bullets and Numbered Lists
Automatic creation of numbered lists in single or multiple levels, or of bulleted lists with a choice of bullet pictures	Bullets and Numbered Lists
Context-Sensitive Help
Import and export context map files that are compatible with C, Pascal, or Visual Basic	Programmer Provides Context Numbers and Exporting Context Map Files
Automatic generation of context mapping numbers for entire project	To Assign Context Numbers to All Existing Topics
Formatting
Format bar	Using the Format Bar
Paragraph style accelerators	Creating New Styles
Expanded and customizable toolbar	Using the Toolbar
Generating Manuals
Generation of a hardcopy document from the ForeHelp database	Manual Generation
Pictures
Preview of graphic when inserting graphic file	Inserting Pictures
Identification of graphic file and directory in the status line	Using the Status line
New naming scheme for .SHG files	Putting Hotspots on Pictures
Scaling and cropping of pictures	Scaling and Cropping Pictures
Control of the order in which the Tab key or Return key moves through hotspots on a picture	Putting Hotspots on Pictures
Display of 256-color bitmap as 16-color to match the WinHelp display	256-Color Bitmap DLL
Hotspots
Automatic updates of hotspots when target context strings change	Editing Targets or Changing Topic Properties
Display topics alphabetically by context string instead of title when making or editing jumps and popups	Creating Jumps or Creating Popups
New Edit Hotspot button	See Edit in the button list in Toolbar Buttons
Ability to delete targets connected with hotspots and recreate the links by reassigning the context string	Deleting Targets
Easier creation of targets	Creating Targets
Importing .RTF Files
Quick conversion of hardcopy manuals to help files	Inserting a Manual's .RTF File
Recreate help files from .RTF files, including jumps, popups, hotspots, targets, topics, macros, keywords	Recreating a Help File from an .RTF File
Keywords
Insert Text Keyword to place your reader at a specific line of the topic	Adding Text Keywords
Make topic title a keyword automatically when creating topics or inserting an .RTF file	Creating New Topics
Make Keyword button on toolbar to assign new keywords while in a topic	Adding Topic Keywords
Macros
Capability of organizing frequently used macros into sets for easy assignment	Organizing Macros into Sets
Improved method of defining WinHelp macros	Adding Macros
Navigation
Two new shortcuts for moving through topic list: Topic|Goto Next Topic and Topic|Goto Previous Topic	Topic Menu
Goto dialog box can display topics by context string or by topic title	Goto Dialog Box
Expanded display capability in Navigator to more than three horizontal levels	Navigator
Project Management
Control over opening the last edited project automatically or displaying the New/Open/Open As Template dialog box when starting ForeHelp	Preferences
Can start more than one copy of ForeHelp and thereby open more than one project at a time	ForeHelp Projects
Several new Reporter options including keyword and statistics sections	Reporter
Support of template databases to create a new ForeHelp database from an existing database	Templates
Ability to rename the database being restored from a backup (.FHB) file	Opening a Backup
New Save Project and Revert Project commands on the File menu	Saving Your Project
Ability to place and manage help project text in multiple .RTF files	Creating Rich Text Format (.RTF) Files
Management of project directories within ForeHelp	Project Paths
Tables
Improved performance when updating tables
Topics
New Copy Topic command for creating new topics from existing topics	Copying Topics
New Generate Table of Contents command	Table of Contents
New Hard Space and Line Break commands on the Text menu	Text Menu
Capability to insert .RTF text from a file or from the Clipboard with management of styles and topics	Paste Special and Inserting Rich Text Format (.RTF) Files
Window Classes
Sample window for easily sizing main and secondary window classes	Creating and Deleting Window Classes
Windows DLLs
Improved handling of embedded window DLLs including possible WYSIWYG display in Edit and Test modes	Embedded Windows
Capability of inserting add-on DLLs that work with ForeHelp projects	Insert Special`
Workspace Display
Ability to remove labels from toolbar buttons	Preferences
Ability to display dialog boxes in single dimension rather than 3-D	Preferences


WinHelp

WinHelp is the hypertext help system built into Microsoft Windows, which you use to run your .HLP file created by ForeHelp.  The executable file is called WINHELP.EXE.


WinHelp Macro Commands

Click on the following for a description of the WinHelp macro's default syntax.  For detailed information, see the Microsoft Software Development Kit or Visual C++.

WinHelp Macro	Function

About	Displays the About dialog box

AddAccelerator or AA	Assigns a macro to an accelerator key

Annotate	Displays the Annotation dialog box

AppendItem	Appends a menu item

Back	Displays previous topic in the history list

BookmarkDefine	Displays the Bookmark Define dialog box

BookmarkMore	Displays the Bookmark dialog box, listing more bookmarks.  The More command appears on the Bookmark menu if the menu lists more than nine bookmarks.

BrowseButtons 	Adds browse buttons

ChangeButtonBinding or CBB	Assigns a macro to a button

ChangeItemBinding or CIB	Assigns a macro to a menu item

CheckItem or CI	Checks a menu item

CloseWindow 	Closes a window

Contents	Displays the Contents topic

CopyDialog	Displays the Copy dialog box

CopyTopic	Copies current topic to the Clipboard

CreateButton or CB	Adds a new button to the button bar

DeleteItem	Removes a menu item

DeleteMark	Deletes a text marker

DestroyButton	Removes a button from the button bar

DisableButton or DB	Disables a button

DisableItem or DI	Disables a menu item

EnableButton or EB	Enables a button

EnableItem or EI	Enables a menu item

ExecProgram or EP	Executes a program

Exit	Exits WinHelp

FileOpen	Displays the Open dialog box

FocusWindow	Changes the focus window

GoToMark	Jumps to a marker

HelpOn	Displays the Help on Using topic

HelpOnTop	Toggles on-top state of help

History	Displays the history list

IfThen	Executes macro if marker exists

IfThenElse	Executes one of two macros if marker exists

InsertItem	Inserts a menu item

InsertMenu	Inserts a new menu

IsMark	Tests if a marker is set

JumpContents	Jumps to the Contents topic

JumpContext or JC	Jumps to the specified context (target)

JumpHelpOn	Jumps to Using Help file

JumpId or JI	Jumps to the specified topic

JumpKeyword or JK	Jumps to the topic containing the keyword

Next	Displays the next topic in the browse sequence

Not	Reverses the IsMark macro

PopupContext or PC	Displays a topic in a popup window

PopupId or PI	Displays a topic in a popup window

PositionWindow or PW	Sets the size and position of a window

Prev	Displays the previous topic in a browse sequence

Print	Prints the current topic

PrinterSetup	Displays the Printer Setup dialog box

RegisterRoutine or RR	Registers a DLL function

RemoveAccelerator or RA	Removes a macro assigned to an accelerator key

SaveMark	Saves a marker

Search	Displays the Search dialog box

SetContents	Sets the Contents topic

SetHelpOnFile	Sets the Using Help help file

UncheckItem or UI	Unchecks a menu item


Window Classes

Your project always has a main window class in which the topics are displayed by default.  You can modify the main window class but you cannot delete it.  You can also create as many as five secondary window classes.  You can modify and delete any secondary window classes.  See Things to Know about Secondary Windows below.

With window classes, you can:

Change the size and position of the main or secondary windows

Have the main or secondary window open to the full size of the screen

Change the background color of the banner or body of the main or secondary windows

Jump to a target that is displayed in a separate secondary window, while keeping the current topic on the screen in the main window.

To jump to a secondary window, you must first create the window and then select its name in the Window Class field of the Make Jump dialog box.  The destination topic appears in a second window on top of the main window.  The topic containing the jump hotspot remains in the main window.  In this way, you can display types of information that you want to set off or keep visible (such as a glossary list, index, procedures, references, examples).

Things to Know about Secondary Windows:

Only one secondary window can be open at a time.  If you jump to a secondary window while another is already open, the new window replaces the existing window.

The reader must close the secondary window separately from the main window.

The Help History does not include topics that appeared in a secondary window.

Secondary windows do not contain button bars or menus.  However, you can create your own buttons in the banner and assign macros to these buttons.

The reader can resize or move a secondary window when it is displayed.  However, the secondary window always opens to the size and location you specify when creating it.

The reader can minimize a secondary window.  A restored secondary window returns to the same size and location as when it was minimized.

You can display any topic in a secondary window by creating a jump to it.

You can use jumps, popups, and macros in topics that you display in a secondary window.


Window Classes Definition
Window Classes

Window classes allow you to set appearance attributes for the main and secondary windows.  The default window class is main.  A secondary window is a window that displays on top of the main window and remains open until explicitly closed.  Only one secondary window can be open at a time.  See Window Classes.


Windows Help History Dialog Box

Choose the Topic|History command, press [image] [image], or click on the [image] toolbar button to access the Windows Help History dialog box.  The window pops up on top of the ForeHelp window.  The window contains the last 40 topics you have displayed, with the most recently displayed topic first.  Double-click on any topic in the list to display that topic.


Working with Pictures in Text

When you place pictures within text, ForeHelp lets you wrap the text around the picture if you want or you can place the picture on the same line as text.  The Insert Picture dialog box and the Edit Placement dialog box allow you to specify where to place the picture and how to wrap the text.  The options are described below with examples using the ForeHelp logo.  In all of the examples, the picture was inserted with the cursor located at the start of the first line of the paragraph.

Character

The graphic is placed on the current line as if it were a character.  Depending on the picture's height, extra space is allocated above the line for the image (if Line Spacing in the Paragraph Format dialog box is not set to Exactly).

Left

The left edge of the graphic is placed at the From Left indent setting in the Paragraph Format dialog box (the left margin icon on the ruler).  Continuous text wraps around the right edge of the picture.  If the height of the picture is less than the height of the paragraph, the remaining text wraps to the left margin below the picture, as in this example.  To start a new paragraph below the graphic, press [image].  To provide the appearance of a new paragraph next to the picture, press [image] [image] to create a new line and format that line to look like your paragraph.  (For example, if you use indented paragraphs, insert a tab to create the first line indent.  If you use block paragraphs, insert two new lines to create the blank line between paragraphs.)

Right

The right edge of the graphic is placed at the From Right indent setting in the Paragraph Format dialog box (the right margin icon on the ruler.)  Continuous text wraps around the left edge of the picture.  Press [image] to begin the next paragraph below the graphic.  Press [image] [image] to make the text continue to wrap alongside.


Workspace

ForeHelp Window

The ForeHelp main area in which you enter the text and graphics.  You can enlarge the size of the workspace by turning off ruler, toolbar, format bar, and status line displays in Preferences.